Build Your Own Rockbox

1. Get the source

Check out the trunk from SVN (recommended) or extract a downloaded archive.

   $ svn co svn://svn.rockbox.org/rockbox/trunk rockbox

   $ 7z x rockbox.7z

2. Create a build directory

Create a build directory, preferably in the same directory as the firmware/ and apps/ directories. This is where all generated files will be written.

   $ cd rockbox
   $ mkdir build
   $ cd build

3. Run configure

In your build directory, run the 'tools/configure' script and enter what target you want to build for and kind of build you want to build. Normally you want to compile the normal build, which is also the default value at this promt. It'll prompt you. The debug version is for making a gdb version out of it. It is only useful if you run gdb towards your target Archos.

   $ ../tools/configure

After you followed the instruction, it will automatically generate a Makefile for you.

Note: Run

   $ ../tools/configure --help

4. Working PATH

Make sure you have the compiler and siblings in the PATH. Make sure that you have 'perl' in your PATH too. For SH1 targets (Archos) this is

   $ which sh-elf-gcc
   $ which perl

   $ which m68k-elf-gcc

   $ which arm-elf-gcc

5. Build

Run 'make' in the build dir and soon the necessary pieces from the firmware and the apps directories have been compiled, linked and scrambled for you.

   $ make

   $ make -j

6. Install

   $ make zip

Extract the newly created rockbox.zip file on your target, reboot it and smile. Recent Rockbox versions need no reboots, just run the Rockbox binary from the Rockbox filebrowser and that'll be loaded and replace the currently running version.

If you would like to build a full zip with the fonts included as well, you'd use this command line instead:

   $ make fullzip

7. Multiple Versions

If you want to have more than one source tree on your PC, just alter the SVN a bit

   $ svn co svn://svn.rockbox.org/rockbox/trunk rockbox_another_tree

If you want to build for more than one target, just create several build directories and create a setup for each target:

   $ mkdir build-fmrecorder
   $ cd build-fmrecorder
   $ ../tools/configure

   $ mkdir build-player
   $ cd build-player
   $ ../tools/configure

8. Ui Simulator

The Ui Simulator simulates Rockbox right on your PC. Please visit UiSimulator for more information about it.