# Rockbox

Rockbox is a free and open-source software replacement for the OEM firmware in various forms of digital audio players (DAPs) with an original kernel. It offers an alternative to the player's operating system, in many cases without removing the original firmware, which provides a plug-in architecture for adding various enhancements and functions. Enhancements include personal digital assistant (PDA) functions, applications, utilities, and games. Rockbox can also retrofit video playback functions on players first released in mid-2000. Rockbox includes a voice-driven user-interface suitable for operation by visually impaired users.
Rockbox runs on a wide variety of devices with very different hardware abilities: from early Archos players with 1-bit character cell-based displays, to modern players with high resolution color displays, digital optical audio hardware and advanced recording abilities.

## History

The Rockbox project was founded by the three Swedish developers Linus Feltzing, Björn Stenberg and Daniel Stenberg in late 2001. It was first implemented on the early Archos series of hard-disk based MP3 players/recorders (including the flash-only model Ondio), because of owner frustration with severe limitations in the manufacturer-supplied user interface and device operations. These devices have relatively weak main central processing units (CPU), and instead offload music playback to dedicated hardware MP3 decoding chips (MAS). Rockbox was unable to significantly alter playback abilities. Instead, it offered a greatly improved user interface and added plug-in functions absent in the factory firmware. Rockbox can be permanently flashed into flash memory on the Archos devices, making it a firmware replacement.
Versions of Rockbox have since been produced for more sophisticated devices. These perform audio decoding in software, allowing Rockbox to potentially support many more music formats than the original firmware, and adding the extensibility and increased functions already present in the Archos ports. Rockbox is run from the hard drive or flash memory after being started with a custom boot loader, so to upgrade Rockbox, users need only copy the files onto the player's drive and restart the device. Reflashing is only needed when changing the boot loader, and on some platforms is not needed at all.
The first of these ports, beginning in late 2004, was for the ColdFire-powered devices manufactured by iriver, focusing on the H1xx series of hard drive players (H110/H120/H140). About one year later, a port for the H3xx series became functional, offering similar functions. In late 2005, work began on a port of Rockbox to Apple's iPod portable players based on CPUs from ARM Ltd. incorporated into systems on a chip sold by PortalPlayer. Throughout 2006, Rockbox ports were made available for a variety of iPod models. Beginning in 2007, ports became available for a large number of additional ARM based targets, including players from Sandisk, Toshiba, Olympus and Philips in addition to newer Apple and iRiver players based on a variety of ARM7, ARM9 and ARM11 series processors. During this time, extensive work was conducted optimizing open source audio decoders for each of the ARM series processors. In 2008, porting began to processors based on the MIPS architecture. In 2010, work began on supporting "hosted" architectures where Rockbox runs as an application inside of more complex operating system.
As of 2012, all Rockbox ports have been accomplished by reverse engineering with little or no manufacturer assistance. As free software, many Rockbox developers and supporters hope to eventually see official manufacturer support for new ports, or at least unofficial assistance in porting Rockbox to new devices. Only a few companies have expressed interest in Rockbox, and none have officially contributed code to the project or included it with their hardware. The Sansa e200v1 port is the first to be started at the request of the hardware manufacturer, who gave the Rockbox team samples of their devices.
Rockbox is continuously developed, with new Git builds being released after every source change, and stable releases every 4 months for targets deemed sufficiently mature. Additionally builds are often available to developers of unsupported targets, which, while somewhat functional, are typically not ready for general users due to incomplete features or poor stability.
As of 2024, there have been no new ports released.

### Future

Rockbox is targeted primarily at digital audio players, rather than the much more powerful general-purpose devices (such as smartphones and tablet computers) that have been increasing in popularity since 2010. Some authorities expect the former class of devices to become obsolete in the next few years.
Daniel Stenberg, a founder of the Rockbox project, envisions the project evolving away from a standalone Rockbox operating system to Rockbox as a media player application that runs under mobile operating systems, such as Android, iOS, Sailfish OS or Tizen:
   In a chat after my Rockbox talk at Fosdem 2010, two other core Rockbox developers (Zagor and gevaerts) seemed to agree to the general view that a Rockbox future involves it running as an application.
   Out of the existing systems mentioned above, I'd prefer to start this work focused on Android. It has the widest company backing combined with open source, and it's also the most used open phone OS. I don't think there's anything that will prevent us from working on all those platforms, as the back-bone should be able to remain the same and portable code we already have and use. Heck, it could then also become more of a regular app for common desktops, too.
A project to port Rockbox to run as an application under a full-fledged operating system was accepted for Google's 2010 Summer of Code and completed. Currently, Rockbox runs on Android based players, but integration into Android and conversion to work with touch based devices is ongoing. Subsequently, an anonymous Chinese developer unofficially ported Rockbox to Palm's WebOS.

## Customization

Subject to the limitations of each particular platform, the appearance of Rockbox can be customised in various ways. Fonts and foreground and background colours can be added and selected, while a simple markup language can be used to create themes for the menu and playback screens. These themes can include backgrounds and other images (such as icons), plus various formats for file names, ID3 tags, album art, file progress, and time and system information.
Rockbox has essentially been a file-tree based player, to which folders could be dragged and dropped and then navigated by folder structure. However, more recent versions have included a complementary database feature which allows the player to compile information from the files' ID3 tags. The user can then navigate the files regardless of file structure.

## Features
### Target status

Rockbox has many features additional to those supported by the original operating firmware, but in many cases there are limitations. On platforms classified as "stable" and supported, the device can be used as a digital music player, but even on some such platforms Rockbox does not support charging or USB; the player must be dual-booted into the original firmware to be charged or to transfer files. Some platforms are classified as "unstable", but supported; those deemed "unusable" are not supported, and their use is not recommended. Some porting projects are in a pre-development hunting and gathering stage, with no code written.

### Codecs

Rockbox on software decoding platforms (non-Archos) supports playback of twelve lossy codecs (depending on how one counts), five lossless, two uncompressed and twelve miscellaneous formats. This makes a conservative total of 30 supported audio formats, although a few of them do not operate in realtime on all platforms. Extensive work has gone into optimizing each codec, with FLAC, Ogg Vorbis, WMA, APE, TTA, MPC, Wavpack, ATRAC3, Cook and WMA Pro among the fastest known integer implementations for those formats.

#### Lossy formats

* MPEG audio layers I-III (MP3/MP2/MP1)
* Ogg Vorbis
* MPEG-4 AAC(-LC/HE/HEv2 profiles) (in MP4 or RM containers)
* Musepack
* AC3 (raw or RM container)
* WMA Standard
* WMA Professional
* Speex
* Cook
* ATRAC3
* The lossy portion of WavPack hybrid files
* Opus

#### Lossless formats

* FLAC
* ALAC
* WavPack
* Shorten
* Monkey's Audio
* TTA

#### Uncompressed formats

* WAV
* AIFF
Together they include over a dozen different PCM and ADPCM formats.

#### Miscellaneous formats

In addition, there are playback of game audio types ADX, SID, NSF, SAP, SPC, AY, GBS, HES, KSS, SGC, VGM, and VGZ. The MOD tracker format, and the Yamaha SMAF are also now supported.
Some profiles in Monkey's Audio are not real time on all targets due to very high CPU needs. Also, Rockbox will not play files with a digital rights management (DRM) scheme.

### Rockbox features

Beside the ability of playing and recording audio files, Rockbox offers many playback enhancements that other firmware packages may not have implemented yet. Listed below are a handful of these features.
* Gapless playback
* Crossfading
* ReplayGain
* 10 band fully parametric equalizer
* Variable speed decoding with pitch correction
* Crossfeed
* OTF ("on the fly") playlists
* True random shuffle (fresh randomly shuffled list every time)
* Custom UI themes
* Dynamic Playlists (queue files to play next, or in other parts of a dynamic playlist)
* Stereo voice/MIC & FM radio recording to WAV/AIFF/WavPack (lossless) and MP3 (limited model/device/target support)
* Remote control (supporting devices)
* Digital S/PDIF input/output (supporting devices)
* Last.fm support (even on players lacking RTC)
* Cue sheet support
* Album art
* Sleep timer

### Plug-ins

Rockbox developers can create plug-ins, which provide the user with other enhancements that may not be available on various firmware modules.
Available plug-ins include:
* JPEG viewer (16 bit color/129 shade greyscale)
* Rockboy Game Boy emulator (port of Gnuboy)
* ZXBox ZX Spectrum emulator (port of Spectemu)
* Doom (port of the PrBoom engine)
* Duke Nukem 3D, Quake, and Wolfenstein 3D running atop a version of the Simple DirectMedia Layer runtime
* XWorld, a clone of Another World
* WAV to MP3 and Wavpack encoder
* MPEG video player
* PictureFlow, an album art viewer similar to Apple's Cover Flow
* Various games including 2048, Sudoku, Solitaire, Chess, Minesweeper, Pong and many others (see https://www.rockbox.org/wiki/PluginIndex for an official list of plug-ins)
* Musical Instrument Digital Interface (MIDI) player, real-time on some targets.
* MikMod, used to play multiple module file formats

## Retired ports

Source:
* ArchosFAQ - Archos Player/Studio, Recorder v1, v2 and FM
* ArchosOndio - Archos Ondio SP/FM Port index

## Stable and functional ports

Source:
* AgptekRocker - AGPtek Rocker Port Index
* AIGOErosQK - AIGO EROS Q / K Port Index
* CreativeZENMozaicPort - Creative Zen Mozaic Port Index
* CreativeZENXFiPort - Creative Zen X-Fi Port Index
* CreativeZENXFi3Port - Creative Zen X-Fi 3 Port Index
* CreativeZENXFiStylePort - Creative ZEN X-Fi Style Port Index
* FiioM3K - FiiO M3K Port Index
* GigabeatFXPort - Toshiba Gigabeat F and X Series Port Index
* GigabeatSPort - Gigabeat S Port Index
* IaudioPort - iAudio X5/M5/M3 Port Index
* IpodPort - iPod Port Index
* IriverH10Port - iriver H10 Port Index
* IriverPort - iriver h1x0 and h3x0 Port Index
* MPIOHD300Port - MPIO HD300 Port Index
* OlympusMR100Port - Olympus M:Robe 100 Port Index
* OlympusMR500Info - Olympus M:Robe 500 Port Index
* PackardBellVibe500Port - Packard Bell Vibe 500 Port Index
* GoGearHDD6330 - Philips GoGear HDD1630/63X0 Port Index
* GoGearSA9200info - Philips GoGearSA9200 Port Index
* SamsungYH92xPort -Samsung YH-820, YH-920 and YH-925 Port Index
* SansaC200Port - Sandisk Sansa c200 Port index
* SansaE200Port - Sandisk Sansa e200 and e200R Port Index
* SansaAMS - Sandisk Sansa AMS (c200v2, e200v2, m200v4, Clip, Fuze) Port Index
* SansaFuzePlusPort - Sansa Fuze+ Port Index
* SonyNWZE360Port - Sony NWZ-E360 Port Index
* SonyNWZE370Port - Sony NWZ-E370 Port Index
* SonyNWZE380 - Sony NWZ-E380 Port Index
* XDuooX3 - XDuoo X3 Port Index
* XDuooX3ii - XDuoo X3ii & X20 Port Index

## Unstable ports

Source:
* CowonD2Info - Cowon D2 Port Index
* CreativeZENPort - Creative Zen Port Index
* CreativeZENXFi2Port - Creative Zen X-Fi 2 Port Index
* HifietMAPort - HiFi E.T. MA8 and MA9 Port Index
* HifimanPort - HiFiMAN HM-60x and HM-801 Port Index
* IhifiPort -iHIFI 760/960, 770, 770C, 800 Port Index
* MPIOHD200Port - MPIO HD200 Port Index
* OndaVX747 - Onda VX747 Port Index
* Rockchip27xxPort - Rockchip 27xx Port Index
* SamsungYPR0 - Samsung YP-R0 Port Index
* SamsungYPR1 - Samsung YP-R1 Port Index
* SamsungZ5 - Samsung YP-Z5 Port Index
* SansaConnect - Sandisk Sansa Connect Port Index
* ShanlingQ1Port - Shanling Q1 Port Index
* ShanlingM2sPort - Shanling M2s Port Index
* SonyNWLinuxPort - Linux-based Sony Port Index

## Architecture

Rockbox uses a simple kernel, with a flat memory model and single process, letting it run on platforms without a memory management unit. Thin threads run cooperatively, returning control to a scheduler that prioritizes the audio thread; the only form of preemption is through interrupts. The operating system and plug-ins are written in C, with assembly used for code that is device- and platform-specific, and performance sensitive. The simple and lightweight architecture allows Rockbox to run on a variety of targets, with memory ranging from 1 to 64 MB, and CPU speeds ranging 12 to 532 MHz. Rockbox also provides support for multicore and asymmetric multiprocessor systems based on ARM, ColdFire, MIPS and SH. Several codecs can be parallelized across 2 CPU cores for increased power efficiency, and the HWCODEC interface allows for dedicated audio decoder DSPs.

## Rockbox Utility

The Rockbox Utility is a free computer application, available for Linux, Mac OS X, and Microsoft Windows, built using Digia Qt platform, that is used to install and manage Rockbox on DAPs. Rockbox Utility provides automatic installation of Rockbox, as well as themes and voice files, directly onto a DAP with minimal user interaction. Rockbox Utility is updated frequently as support for new devices is added.