Enable JavaScript to show search field.
2 Installation
Installing Rockbox is generally a quick and easy procedure. However before beginning there
are a few important things to know.
2.1 Before Starting
-
Supported hardware versions.
- The c200 Series is available in multiple versions, and you
need to make sure which you have by checking the Sandisk firmware version number
under Settings → Info. The v1 firmware is named 01.xx.xx, while the v2 firmware
begins with 03. Make sure that you are following the instructions from the correct
manual.
-
USB connection.
- To transfer Rockbox to your player you need to connect it to your
computer. For manual installation/uninstallation, or should autodetection fail
during automatic installation, you need to know where to access the player. On
Windows this means you need to know the drive letter associated with the player.
On Linux you need to know the mount point of your player. On Mac OS X you
need to know the volume name of your player.
Note: The following steps require you to change the setting in Settings → USB
Mode to MSC from within the original firmware.
Warning: Never extract files to your player while it is in recovery mode.
-
Administrator/Root rights.
- Installing the bootloader portion of Rockbox requires you
to have administrative (Windows) or root (Linux) rights. Consequently when doing
either the automatic or manual bootloader install, please ensure that you are logged
in with an administrator account or have root rights.
2.2 Installing Rockbox
There are two ways to install Rockbox: automated and manual. The automated way is the
preferred method of installing Rockbox for the majority of people. Rockbox Utility is a
graphical application that does almost everything for you. However, should you encounter a
problem, then the manual way is still available to you.
There are three separate components, two of which need to be installed in order to run
Rockbox:
-
The Sansa bootloader.
- The Sansa bootloader is the program that tells your player how
to load and start the original firmware. It is also responsible for any emergency,
recovery, or disk modes on your player. This bootloader is stored in special flash
memory in your Sansa and comes factory-installed. It is not necessary to modify
this in order to install Rockbox.
-
The Rockbox bootloader.
- The Rockbox bootloader is loaded from disk by the Sansa
bootloader. It is responsible for loading the Rockbox firmware and for providing
the dual boot function. It directly replaces the Sansa firmware in the player’s boot
sequence.
-
The Rockbox firmware.
- Similar to the Sansa firmware, most of the Rockbox code is
contained in a “build” that resides on your player’s drive. This makes it easy to
update Rockbox. The build consists of a directory called .rockbox which contains
all of the Rockbox files, and is located in the root of your player’s drive.
Apart from the required parts there are some addons you might be interested in
installing.
-
Fonts.
- Rockbox can load custom fonts. The fonts are distributed as a separate package
and thus need to be installed separately. They are not required to run Rockbox
itself but a lot of themes require the fonts package to be installed.
-
Themes.
- The appearance of Rockbox can be customised by themes. Depending on your
taste you might want to install additional themes to change the look of Rockbox.
2.2.1 Automated Installation
To automatically install Rockbox, download the official installer and housekeeping tool
Rockbox Utility. It allows you to:
- Automatically install all needed components for using Rockbox (“Minimal
Installation”).
- Automatically install all suggested components (“Complete Installation”).
- Selectively install optional components.
- Install additional fonts and themes.
- Install voice files and generate talk clips.
- Uninstall all components you installed using Rockbox Utility.
Prebuilt binaries for Windows, Linux and Mac OS X are available at the RockboxUtility wiki
page.
When first starting Rockbox Utility run “Autodetect”, found in the configuration dialog (File
→ Configure). Autodetection can detect most player types. If autodetection fails
or is unable to detect the mountpoint, make sure to enter the correct values. The
mountpoint indicates the location of the player in your filesystem. On Windows, this
is the drive letter the player gets assigned, on other systems this is a path in the
filesystem.
Choosing a Rockbox version
There are three different versions of Rockbox available from the Rockbox website: Release
version, current build and archived daily build. You need to decide which one you want to
install and get the appropriate version for your player. If you select either “Minimal
Installation” or “Complete Installation” from the “Quick Start” tab, then Rockbox Utility will
automatically install the release version of Rockbox. Using the “Installation” tab will allow
you to select which version you wish to install.
-
Release.
- The release version is the latest stable release, free of known critical bugs.
For a manual install, the current stable release of Rockbox is available at
http://www.rockbox.org/download/.
-
Development Build.
- The development build is built at each change to the Rockbox
source code repository and represents the current state of Rockbox development.
This means that the build could contain bugs but most of the time is
safe to use. For a manual install, you can download the current build from
http://build.rockbox.org/.
-
Archived Build.
- In addition to the release version and the current build, there is also
an archive of daily builds available for download. These are built once a day from
the latest source code in the repository. For a manual install, you can download
archived builds from http://www.rockbox.org/daily.shtml.
Note: Because current and archived builds are development versions that change frequently,
they may behave differently than described in this manual, or they may introduce new (and
potentially annoying) bugs. Unless you wish to try the latest and greatest features at the price
of possibly greater instability, or you wish to help with development, you should stick with the
release.
Please now go to section 2.2.3 to complete the installation procedure.
2.2.2 Manual Installation
The manual installation method is still available to you, should you need or desire it
by following the instructions below. If you have used Rockbox Utility to install
Rockbox, then you do not need to follow the next section and can skip straight to
section 2.2.3
Installing the firmware
-
1.
- Download your chosen version of Rockbox from the links in the previous section.
-
2.
- Connect your player to the computer via USB in MSC mode as described in the
manual that came with your player.
-
3.
- Take the .zip file that you downloaded and use the “Extract all” command of
your unzip program to extract the files onto your player.
Note: The entire contents of the .zip file should be extracted directly to the root of
your player’s drive. Do not try to create a separate directory on your player for the
Rockbox files! The .zip file already contains the internal structure that Rockbox
needs.
If the contents of the .zip file are extracted correctly, you will have a directory called
.rockbox, which contains all the files needed by Rockbox, in the main directory of your
player’s drive.
Installing the bootloader
Bootloader installation from Windows
-
1.
- Download sansapatcher.exe from http://download.rockbox.org/bootloader/sandisk-_sansa/sansapatcher/win32/sansapatcher.exe
and run it whilst logged in with an administrator account.
-
2.
- If all has gone well, you should see some information displayed about your c200
Series and a message asking you if you wish to install the Rockbox bootloader.
Press i followed by ENTER, and sansapatcher will now install the bootloader. After
a short time you should see the message “[INFO] Bootloader installed successfully.”
Press ENTER again to exit sansapatcher.
Bootloader installation from Mac OS X
-
1.
- Attach your player to your Mac and wait for its icon to appear in Finder.
-
2.
- Download and open sansa.dmg from http://download.rockbox.org/bootloader/sandisk-_sansa/sansapatcher/macosx/sansapatcher.dmg
and then double-click on the sansapatcher icon inside.
-
3.
- If all has gone well, you should see some information displayed about your player
and a message asking you if you wish to install the Rockbox bootloader. Press i
followed by ENTER, and sansapatcher will now unmount your player and install
the bootloader. After a short time you should see the message “[INFO] Bootloader
installed successfully.” Press ENTER again to exit sansapatcher and then quit the
Terminal application.
Bootloader installation from Linux
-
1.
- Download sansapatcher from http://download.rockbox.org/bootloader/sandisk-_sansa/sansapatcher/linux32x86/sansapatcher
(32-bit x86 binary) or http://download.rockbox.org/bootloader/sandisk-_sansa/sansapatcher/linux64amd64/sansapatcher
(64-bit amd64 binary). You can save this anywhere you wish, but the next steps
will assume you have saved it in your home directory.
-
2.
- Attach your player to your computer.
-
3.
- Open up a terminal window and type the following commands:
cd $HOME chmod +x sansapatcher ./sansapatcher
Note: You need to be the root user in order for sansapatcher to have sufficient
permission to perform raw disk access to your player.
-
4.
- If all has gone well, you should see some information displayed about your c200 Series
and a message asking you if you wish to install the Rockbox bootloader. Press i followed
by ENTER, and sansapatcher will now install the bootloader. After a short time you
should see the message “[INFO] Bootloader installed successfully.” Press ENTER again
to exit sansapatcher.
2.2.3 Finishing the install
Safely eject / unmount the USB drive, unplug the cable and restart.
2.2.4 Enabling Speech Support (optional)
If you wish to use speech support you will also need a voice file. Voice files allow Rockbox to
speak the user interface to you. Rockbox Utility can install an English voice file, or you can
download it from http://www.rockbox.org/daily.shtml and unzip it to the root of
your player. Rockbox Utility can also aid you in the creation of voice files with
different voices or in other languages if you have a suitable speech engine installed on
your computer. Voice menus are enabled by default and will come into effect after
a reboot. See section 8.10 for details on voice settings. Rockbox Utility can also
aid in the production of talk files, which allow Rockbox to speak file and folder
names.
2.3 Running Rockbox
When you turn the unit on, Rockbox should load.
2.4 Updating Rockbox
Rockbox can be easily updated with Rockbox Utility. You can also update Rockbox manually
– download a Rockbox build as detailed above, and unzip the build to the root directory of
your player as in the manual installation stage. If your unzip program asks you whether to
overwrite files, choose the “Yes to all” option. The new build will be installed over your
current build.
The bootloader only changes rarely, and should not normally need to be updated.
Note: If you use Rockbox Utility be aware that it cannot detect manually installed
components.
2.5 Uninstalling Rockbox
Note: The Rockbox bootloader allows you to choose between Rockbox and the original
firmware. (See section 3.1.3 for more information.)
2.5.1 Automatic Uninstallation
You can uninstall Rockbox automatically by using Rockbox Utility. If you installed Rockbox
manually you can still use Rockbox Utility for uninstallation but will not be able to do this
selectively.
2.5.2 Manual Uninstallation
If you wish to clean up your disk, you may also wish to delete the .rockbox directory and its
contents. Turn the Sansa off. Turn the player back on and the original Sansa software will
load.
2.6 Troubleshooting
-
Bootloader install problems
- If you have trouble installing the bootloader, please ensure
that you are either logged in as an administrator (Windows), or you have root
rights (Linux)
-
“File Not Found”
- If you receive a “File Not Found” from the bootloader, then the
bootloader cannot find the Rockbox firmware. This is usually a result of not
extracting the contents of the .zip file to the proper location, and should not
happen when Rockbox has been installed with Rockbox Utility.
To fix this, either install Rockbox with the Rockbox Utility which will take care
of this for you, or recheck the Manual Install section to see where the files need to
be located.