Skip to content

← Rockbox-Y1 hub

Rockbox-Y1 · themes & Updater CE

Rockbox-Y1 themes: transfer with Updater CE, pick the build, then the look

Updater CE handles Rockbox-Y1 themes and fonts for you — transferring them to the Y1 automatically whenever it can, and guiding you through the transfer step by step when it cannot happen unattended (for example, right after an MTKClient firmware install on macOS or Linux).

Transferring themes to the Y1 with Updater CE

Rockbox stores its firmware in the Y1's internal flash, while themes, fonts, and user settings live inside the hidden .rockbox folder on the player's storage (MicroSD card). Because flashing a ROM and copying files to storage use two different connections, Updater CE adapts automatically to your operating system and install method:

240p, 360p, and why the label is on the build

Y1 community builds are published with a resolution label, and the theme collections carry the same label. 240p builds have the broadest compatibility with older theme packs; 360p builds are made for the newer Y1 theme path. Installing one and applying the other is not dangerous — it just looks wrong, with clipped text, missing elements, or an interface you cannot read.

If you have no theme preference yet, take the newer stable build and its default theme, then choose themes that match its label. The resolution page goes deeper; the rule of thumb is simple: build label and theme label must agree.

Where themes live

Themes are files on the MicroSD card, inside the .rockbox folder — the same folder that holds settings and caches. The firmware itself is on internal flash, so adding, changing or removing a theme never requires reflashing.

Turn on hidden files first if you cannot see the folder: macOS Cmd+Shift+., Windows View → Hidden items, Linux Ctrl+H.

Applying a theme, in order

  1. Install and boot Rockbox-Y1 first; a theme needs a running build.
  2. Copy the theme folder to .rockbox/themes on the card.
  3. Open the theme settings and select the theme.
  4. Reboot so the whole interface — not just the menu — picks it up.
  5. If it looks broken, select another theme; the files are still there if you want to retry later.

Undoing a theme that broke the interface

If the player boots into something unusable, you do not need to reinstall the firmware. Rename or delete the .rockbox folder on the card and start the player: the build recreates the folder with default settings and a default theme. Your music is untouched, and you can copy the themes you want back afterwards.

Questions people ask

Why does Updater CE walk me through transferring themes after an MTKClient install on macOS or Linux?

MTKClient flashes the Rockbox ROM to internal storage while your Y1 is powered off in low-level Preloader/BROM mode, before Rockbox has booted to initialize the .rockbox folder and before the MicroSD card is mounted on your computer. Whenever Updater CE can reach the booted player directly (via ADB or a mounted USB drive), it transfers the themes automatically; when it cannot do that unattended during the flash, it opens the guided themes & fonts step right after flashing to help you power on the Y1 and complete the transfer via ADB or USB Storage Mode.

Will a Y2 theme work on the Y1?

No. The ports are separate, and theme support on the Y2 follows its beta builds. See Rockbox-Y2 themes.

Do themes survive an update?

Usually yes, because they live on the card and the flash writes the ROM. If a new build changes the theme path, reapply a theme that matches its label.

Why is the theme only half applied?

A reboot normally resolves it. If not, the theme's files are incomplete — re-copy its folder rather than editing individual files.