GraphicalInstall < Main

Downloads
release
dev builds
extras
themes
Documentation
manual
wiki
device status
Support
forums
mailing lists
IRC
Development
bugs
patches
dev guide
Donate
Wiki > Main > WikiManual > GraphicalInstall
---+!! Graphical installation for first time users

%TOC%

---++ Preface

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
<center><img src="%ATTACHURLPATH%/01-rbutil-startup.jpg" alt="01-rbutil-startup.jpg" /></center>

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.

<center><img src="%ATTACHURLPATH%/03-rbutil-detected.jpg" alt="03-rbutil-detected.jpg" /></center>

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.

<center><img src="%ATTACHURLPATH%/02-rbutil-config.jpg" alt="02-rbutil-config.jpg" /></center>

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 time installation you only need the "Installation" tab.

<center><img src="%ATTACHURLPATH%/04-rbutil-main.png" alt="04-rbutil-main.png" /></center>

On the "Installation" tab select the parts of Rockbox you want to install. For a first time install you need at least "Bootloader" and "Rockbox". The "Fonts" package is highly recommended, since additional themes might use the fonts provided with this. When you're done selecting the parts you want (called "packages" in the progress dialog shown later) hit the "Install" button at the bottom. Now the only thing you need to do is wait until the installation finished.

<center><img src="%ATTACHURLPATH%/05-rbutil-versionselection.png" alt="05-rbutil-versionselection.png" /></center>

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.

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

<center><img src="%ATTACHURLPATH%/06-rbutil-installfinished.png" alt="06-rbutil-installfinished.png" /></center>

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). If you have gotten a dialog box telling you that you need to perform additional steps for bootloader installation do them now. It is important that you now perform these steps as otherwise Rockbox won't boot. Please also refer to the [[http://www.rockbox.org/manual.shtml][Manual]] for details.

---++ Finished
Congratulations, you've made it! Please check the [[http://www.rockbox.org/manual.shtml][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.
r8 - 14 Feb 2013 - 20:53:26 - DominikRiebeling
Parents: WikiManual