rockbox

mirror of https://github.com/Rockbox/rockbox.git synced 2026-05-12 11:43:16 -04:00

Mirror of https://github.com/Rockbox/rockbox https://git.rockbox.org/?p=rockbox.git;a=summary

Find a file

Christian Soffke e405858b9e wps: Replace menu items "Open With" & "Delete" with "Show in Files" Limit these (less commonly used) "file handling" operations to the File Browser while making it quicker to reveal the file that is currently playing from the WPS. "Open With" and "Delete" remain available as WPS shortcuts. Change-Id: I91e582a45998160f07a3f7e16d475d770e8c5212		2026-04-16 21:04:27 -04:00
android
apps	wps: Replace menu items "Open With" & "Delete" with "Show in Files"	2026-04-16 21:04:27 -04:00
backdrops
bootloader	misc: get rid of unused LOADADDRESS define in makefiles	2026-03-05 20:11:07 +00:00
docs	pcm_mixer: introduce mixer_buffer_cbs	2026-04-14 06:50:39 -04:00
firmware	hiby: ability to add/remove input device	2026-04-16 08:03:06 -04:00
fonts
icons
lib	3ds: Various fixes, mostly for compiler warnings	2026-03-13 10:24:36 -04:00
manual	wps: Replace menu items "Open With" & "Delete" with "Show in Files"	2026-04-16 21:04:27 -04:00
packaging	3ds: Makefile improvements	2026-03-13 17:52:32 +02:00
tools	voice: Add Norwegian Nynorsk voicefile synthesis	2026-04-01 11:04:53 -04:00
uisimulator	Remove Creative Zen Vision and Vision:M ports	2026-02-06 07:31:54 -05:00
utils	manual: Correct dead links for Sandisk Fuze+ firmware download	2026-04-03 17:33:08 -04:00
wps
.gitattributes
.gitignore	tools: add RegGen utility	2025-12-29 18:51:56 -05:00
.gitreview

docs/README

               __________               __   ___.
     Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
     Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
     Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
     Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
                       \/            \/     \/    \/            \/

Build Your Own Rockbox

1. Clone 'rockbox' from git (or extract a downloaded archive).

   $ git clone git://git.rockbox.org/rockbox

     or

   $ tar xJf rockbox.tar.xz

2. 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. Make sure you have mips/m68k/arm-elf-gcc and siblings in the PATH. Make sure
   that you have 'perl' in your PATH too. Your gcc cross compiler needs to be
   a particular version depending on what player you are compiling for. These
   can be generated using the rockboxdev.sh script in the /tools/ folder of the
   source.

   $ which arm-elf-eabi-gcc
   $ which perl

4. In your build directory, run the 'tools/configure' script and enter what
   target you want to build for and if you want a debug version or not (and a
   few more questions). 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

5. *ploink*. Now you have got a Makefile generated for you.

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

   $ make
   $ make zip

7. unzip the rockbox.zip on your music player, reboot it and
   *smile*.

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

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

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

Questions anyone? Ask on the mailing list or on IRC. We'll be happy to help you!