Rockbox

My personal fork of Rockbox.

Includes GitHub actions workflows for producing builds for the targets I use.

Upstream is merged daily. If the merge conflicts, the conflicted merge is committed as-is (conflict markers and all) and pushed to an upstream-merge branch, and the workflow refuses to run again while that branch exists. To recover: check out upstream-merge, fix the conflicts and amend the merge commit, merge the branch into master, delete the branch, then re-run the workflow.

Releases

Each publish creates its own release, tagged build-<date>-<commit> and carrying one zip per target. The latest release points at the most recent one.

Builds run weekly via the Device Build workflow, which leaves the zips as run artifacts. To publish one, run the workflow manually and tick Publish the build as a release.

Building locally

CI builds inside a container image (built from the Dockerfile) which already has the toolchains for this fork's targets baked in. Build the image locally and use it the same way:

docker build -t rockbox-env .
docker run --rm -it -v "$PWD":/rockbox -w /rockbox rockbox-env bash

Then, inside the container:

mkdir build && cd build
../tools/configure --target=erosqnative --type=n
make -j$(nproc)
make zip

Substitute --target=rg35xxpro and make port-zip to build the Anbernic RG35XX Pro target instead. See .github/workflows/device-build.yml for the exact configure_target/zip_target values CI uses for each target, and .github/workflows/build-image.yml for how the container image itself is built and published.

New targets

⚠️ New targets have been added using LLMs. While these targets have been tested extensively on real hardware, the code changes themselves are largely unreviewed. Good luck! 🙏

Target	--target=	CFW
Anbernic RG35XX Pro	rg35xxpro	KNULLI

Anbernic RG35XX Pro on Knulli

Runs under KNULLI, installed into roms/ports and launched from EmulationStation's Ports collection. Quitting returns to EmulationStation.

Hardware

• SoC: Allwinner H700 (quad-core Cortex-A53, aarch64)
• Screen: 3.5" 640x480 IPS. Rockbox renders at 320x240 (QVGA, for theme compatibility) and integer-upscales 2x onto the panel.
• Colour depth: 16-bit (RGB565)
• Audio: SDL2. Volume handled by the system, rockbox output set to 100% and volume keys mapped out. Internal speaker and 3.5mm jack work without issues.
• Power: left entirely to the system, use power button as usual.

Known issues

None!

Installation

Copy the release zip (rockbox-rg35xxpro-<date>-<commit>.zip) contents onto the device's SHARE partition at /userdata/roms/ports/, giving roms/ports/rockbox.sh and roms/ports/rockbox/. Launch "Rockbox" from EmulationStation's Ports.

Keymap

Button	Action
D-pad / Analog stick	Navigate / seek
A	Select / Play-Pause
B	Back / Stop
X	ID3 info screen (WPS) / open WPS from file browser
Y	Delete bookmark (bookmark screen only)
Menu	Tap: main menu. Hold: exit to EmulationStation
Select	Context menu
Start	Lock keys
L1	Hotkey / WPS shortcut
R1	Quickscreen
Vol Up / Vol Down	System-only
Power	System-only
L2, R2, analog stick click	Unbound
FN	No hardware control; keyboard-only