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

Search | Go
Wiki > Main > WikiManual > GraphicalInstall (r4)

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). The screenshot on this page were made on linux. There is no big difference to Windows or OS X.

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.

Configuring RockboxUtility

The configuration window opens. It will look like the following screenshot.


In most cases you only need to select the correct player model and mountpoint. Please note that the term "mountpoint" refers to the location the player appears on your computer. On Windows this equals to the drive letter (for example, E:\), on linux and OS X this is a path in the filesystem. All players can now get automatically detected. Press the "Autodetect" button to start detection. Shortly after the input box below "Select your device in the filesystem", the so-called "mountpoint", should be filled and a player should be selected from the list. For some players detecting the mountpoint doesn't work. If this happens, just use the "Browse" button behind the Mountpoint entry line. Afterwards the configuration window will look like this (Note: on windows the path "/media/ipod" will be a drive letter, i.e. something like "E:\")


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 players require you to have administrator permissions. 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 RockboxUtility appears. You can now choose from the tabs on the bottom which action you want to perform.


For a first install you most likely want to use one of the two buttons on the "Quick Start" tab. Make your choice between "Complete Install" and "Small Install", press the button, and a progress dialog will appear. Now you just need to wait until all the parts are installed.


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). On Ipods you need to reboot manually by pressing and holding Menu + Select for several seconds. Iriver H100 and H300 require you to manually flash the firmware using the firmware update functionality of the original firmware. Please 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.
r4 - 19 Aug 2008 - 01:16:29 - AnthonyMercuri

Parents: WikiManual
Copyright by the contributing authors.