dev builds
themes manual
device status forums
mailing lists
IRC bugs
dev guide

Wiki > Main > GraphicalInstall (compare)

Difference: GraphicalInstall (r8 vs. r7)

Graphical installation for first time users


This page describes how to install Rockbox using the official graphical installer RockboxUtility. RockboxUtility is available for Windows (2000 and up), Linux and Mac OS X. Prerequisites are:

  • a supported audio player (obviously)
  • a download of RockboxUtility for your PC

Please note: RockboxUtility looks similar on all supported operating systems. This means all buttons are at the same location, the used icons are identical and so forth. The appearance is depending on the graphical view of your operating system -- on windows it'll use the typical windows appearance, while on Linux it'll use the settings of your graphical environment (side note: as RockboxUtility uses Qt 4 this depends on your Qt configuration which might not be identical to your graphical environment). There is no functional difference between the versions for Windows, Mac OS X and Linux. Minor graphical differences are due to the system it runs on.

Starting RockboxUtility


First, start RockboxUtility. If you have never used it before you'll get a configuration error. This is normal as you haven't configured RockboxUtility for your player yet. If you haven't connected your player to the PC do this now. Make sure the player appears on the PC, on windows it needs to get a drive letter assigned. On linux and OS X make sure the player is mounted. If the Utility can't find the player is linux, try running it as root. If you have multiple players please disconnect all but the one you're trying to install.

Configuring RockboxUtility

The configuration window opens. Press the "Autodetect" button to make Rockbox Utility try to detect your player. If a supported player is found you will get the mountpoint value (Windows: drive letter) set to the correct path (Windows: drive letter) and the detected player will be hilighted in the device selection dialog. Please do not select the player manually unless detecting your player doesn't work (in that case you'll get a dialog telling you so). Some players have similar model names but are in fact completely different hardware (for example, Ipod 2G vs. Ipod Nano 2G, or Sansa e200 vs. Sansa e200v2).

Note: when autodetection doesn't work make sure your player is connected properly and has a drive letter assigned. Also, make sure you have appropriate permissions to access the player. Ipod and Sansa e200 and c200 players require you to have administrator permissions.


If you need to select your player manually (again, please try automatic detection first) you need to choose the correct mountpoint (Windows: drive letter) from the dropdown list and the correct player. The dropdown list will show additional information when expanded to help you to identify the correct player.


If you're behind a proxy you might need to change more settings using the "Proxy" tab. Also, you can configure other functionality now. As this isn't required for installation we don't cover this here.

When finished with configuration close the configuration dialog using the "Ok" button.

Main Window

The main window of RockboxUtilityappears. You can now choose from the tabs on the bottom which action you want to perform. For a first time installation you only need the "Installation" tab.


On the "Installation" tab select the parts of Rockbox you want to install. For a first time install you most likely want to need at least "Bootloader" and "Rockbox". The "Fonts" package is highly recommended, since additional themes might use one of the two buttons on fonts provided with this. When you're done selecting the "Quick Start" tab. Make your choice parts you want (called "packages" in between "Complete Install" and "Small Install" and press the button. You will get a progress dialog shown later) hit notice that the installation methods from "Install" button at the "Quick Start" bottom. Now tab will install the latest release. only thing Usually there are more current builds available. It is safe to install a release at first, if you want need to update to a more current build later do is wait until the installation finished. you need to use the installation button from the "Installation" tab. After confirming the message a progress dialog will appear. Now you just need to wait until all the parts are installed.


Note: The default version of Rockbox to be installed is the latest release. You can also select to install a development version in the dropdown menu before starting the installation. If your player doesn't have a released version you only get a development version in the dropdown list. If release candidate builds are available they will also show up in that list. The "Quick Start" installation method is only intended for a first time installation. You can update Rockbox separately later by using the "Installation" tab, updating the bootloader is rarely necessary (Note: not all players require a bootloader. If the Bootloader button in the Installation tab is greyed out you don't need to install a bootloader.)


Changing between versions is simple: just perform an installation of the other version on top of the existing one.

When installation is finished the "Abort" button on the log window changes to "Ok". Press "Ok" and the log window will close. Safely eject (windows) / unmount (linux / OS X) your player. Installation is now almost finished.


After starting the installation process a progress window appears, showing the steps currently done. When installation is finished the "Abort" button on the log window changes to "Ok". Press "Ok" and the log window will close. Safely eject (windows) / unmount (linux / OS X) your player. Installation is now almost finished.

Finishing Installation

Important:after installation you need to reboot your player. Make sure you "safely ejected" your player using your PCs "safely eject" button (unmount on linux / OS X). After If the bootloader has been installed you might get have gotten a dialog box telling you about that additional steps you need to perform, it perform additional steps for bootloader installation do them now. It is important that you now do perform these steps as otherwise Rockbox won't boot. Please also refer to the Manual for details.


Congratulations, you've made it! Please check the Manual for further instructions, and before asking for help. You'll more likely get much better help if you search it first. Besides, Rockbox Utility can download and display the manual -- check the "Manual" tab.

r10 - 21 Dec 2013 - 04:26:06 - ChrisJordan

Revision r8 - 14 Feb 2013 - 20:53 - DominikRiebeling
Revision r7 - 23 Jan 2013 - 04:32 - MichaelGiacomelli
Copyright by the contributing authors.