Part of Slepp's ProjectsPastebinTURLImagebinFilebin
Feedback -- English French German Japanese
Create Upload Newest Tools Donate
Sign In | Create Account

Sunday, October 7th, 2007 at 9:39:17am UTC 

  1. % $Id: installation.tex 14843 2007-09-24 20:12:17Z bluebrother $ %
  2. \chapter{Installation}\label{sec:installation}
  4. \opt{ipodnano}{
  5.   \note{Rockbox presently runs only on the original Ipod Nano. Rockbox does
  6.   \emph{not} run on the newer, second generation Ipod Nano (the all alumminum
  7.   verion). For information on identifying which Ipod you own, see this page on
  8.   Apple's web site: \url{}
  9.   }
  10. }
  12. \section{Overview}
  13. There are two ways of installing Rockbox: automated and manual. While the manual way is older, more tested and proven to work correctly, the automated installation is based on a nice graphical application that does almost everything for you. It is still important that you have an overview of the installation process to enable you to select the correct installation options.
  15. \opt{MASCODEC}{Rockbox itself comes as a single package. There is no need
  16.   to install additional software for running Rockbox.}
  17. \opt{SWCODEC} {
  18.   \opt{HAVE_RB_BL_ON_DISK}{There are three separate components,
  19.     two of which need to be installed in order to run Rockbox.}
  20.   \opt{HAVE_RB_BL_IN_FLASH}{There are two separate components of Rockbox
  21.     that need to be installed in order to run Rockbox.}
  23. \begin{description}
  24. \opt{HAVE_RB_BL_ON_DISK}{
  25. \item[The \playerman{} boot loader.]
  26.   The \playerman{} bootloader is the program that tells your \dap{} how to boot
  27.   and load the firmware from disk. It is also responsible for the
  28.   disk mode on your \dap{}.
  30.   This boot loader is stored in special flash memory in your \playerman{}.
  31.   It is already installed on your \dap{}, so it is never necessary to modify
  32.   this in order to install Rockbox.}
  34. \item[The Rockbox boot loader.] \index{Boot loader}
  35.   \opt{HAVE_RB_BL_ON_DISK}{The Rockbox boot loader is loaded from disk by
  36.   the \playerman{} boot loader. It is responsible for loading the Rockbox
  37.   firmware and for providing the dual boot function. It takes the place of the
  38.   \playerman{} firmware in the \daps{} boot sequence..
  39.   \opt{gigabeat}{\note{Dual boot does not currently work on the gigabeat.}}}
  41.   \opt{HAVE_RB_BL_IN_FLASH}{
  42.   The boot loader is the program that tells your
  43.   \dap{} how to boot and load other components of Rockbox. This is the
  44.   component of Rockbox that is installed to the flash memory of your
  45.   \playerman.}
  47. \item[The Rockbox firmware.]
  48.   \opt{HAVE_RB_BL_IN_FLASH}{Unlike the \playerman{} firmware, which runs
  49.   entirely from flash memory,}
  50.   \opt{HAVE_RB_BL_ON_DISK}{Similar to the \playerman{} firmware,}
  51.   most of the Rockbox code is contained in a
  52.   ``build'' that resides on your \daps{} drive. This makes it easy to
  53.   update Rockbox. The build consists of a directory called
  54.   \fname{.rockbox} containing all the Rockbox files. This directory is located in the root of your \daps{} drive.
  56. \end{description}
  57. }
  59. \nopt{player} {
  60.     Apart from the required parts there are some addons you might be interested
  61.     in installing too.
  62.     \begin{description}
  63.     \item[Fonts.] Rockbox can load custom fonts. The fonts are distributed as a package which needs to be installed separately. The fonts are not required to run Rockbox itself but
  64.         a lot of themes require the fonts package to be installed.
  66.     \item[Themes.] The appearance of Rockbox can be customized with themes. Depending
  67.         on your taste you might want to install additional themes to change
  68.         the look of Rockbox.
  69.     \end{description}
  70. }
  72. \section{Prerequisites}\label{sec:prerequisites}
  73. \index{Installation!Prerequisites}
  74. Before installing Rockbox you should make sure you meet the prerequisites.
  75. You may also need some tools for installation. In most cases these will be
  76. already available on your computer but if not you need to get some additional
  77. software.
  79. \begin{description}
  80. \item[USB connection.] To transfer Rockbox to your \dap{} you need to
  81.   connect it to your computer. For manual installation/uninstallation, or should autodetection fail during automatic installation, you need to know where to access the
  82.   \dap{}. On Windows this means you need to figure out the drive letter associated with the \dap{}. On Linux you need to know the mount point of
  83.   your \dap{}.
  85.   \opt{ipod}{
  86.     Your \dap{} should enter disk mode automatically when connected to a
  87.     computer via USB. If your computer does not recognise your \dap{}, you may
  88.     need to enter the disk mode manually. Disconnect your \dap{} from the
  89.     computer. Reset the \dap{} by pressing and holding the \ButtonMenu{} and
  90.     \ButtonSelect{} buttons simultaneously. As soon as the \dap{} resets, press
  91.     and hold the \ButtonSelect{} and \ButtonPlay{} buttons simultaneously. Your
  92.     \dap{} should enter disk mode and you can try reconnecting to the computer.
  93.   }
  95.   \opt{ipod3g,ipod4g,ipodcolor,ipodmini}{
  96.     \note{\index{Firewire}Firewire detection is not supported in Rockbox at
  97.     the moment. Please use USB only.}
  98.   }
  99. \end{description}
  100. For manual installation and customization, additional software is required.
  101. \begin{description}
  102. \item[ZIP utility.]\index{zip}
  103.   Rockbox is distributed as a compressed archive using the
  104.   \fname{.zip} file format. You need a tool capable of handling this. Most computers will have one already installed. Windows XP has built-in support for
  105.   \fname{.zip} files and presents them to you as directories, unless you have
  106.   installed a third-party program that handles compressed files. For
  107.   other operating systems this may vary. If the \fname{.zip} file format
  108.   is not recognised on your computer you can find a program to handle them
  109.   at \url{} or \url{}, which
  110.   can be downloaded and used free of charge.
  111. \item[Text editor.] As you will see in the following chapters, Rockbox is
  112.   highly configurable. In addition to saving configurations within Rockbox, you can also create customised configuration files. If you
  113.   would like to edit custom configuration files on your computer, you will
  114.   need a text editor like Windows' ``Wordpad''.
  115. \end{description}
  117. \opt{ipod}{
  118.   \note{In addition to the requirements described above, Rockbox only works on
  119.   Ipods formatted with the FAT32 filesystem (i.e., Ipods initialized by iTunes
  120.   for Windows). It does not work with the HFS+ filesystem (i.e. Ipods
  121.   initialized by iTunes for the Mac). More information and instructions for
  122.   converting an Ipod to FAT32 can be found on the
  123.   \wikilink{IpodConversionToFAT32} wiki
  124.   page on the Rockbox web site.  Note that after conversion, you can still use
  125.   a FAT32 Ipod on a Mac.
  126.   }
  127. }
  129. \section{Installing Rockbox}\label{sec:installing_rockbox}\index{Installation}
  130. \subsection{Automated Installation}
  131. To automatically install Rockbox, download the official installer and housekeeping tool \textsc{Rockbox Utility}. It allows you to:
  132. \begin{itemize}
  133. \item Automatically install all needed components for using Rockbox
  134.         (``Small Installation'')
  135. \item Automatically install all suggested components (``Full Installation'')
  136. \item Selectively install any available parts of Rockbox
  137. \item Install additional themes
  138. \item Install voice files and generate talk clips
  139. \item Uninstall all components you installed using Rockbox Utility
  140. \end{itemize}
  141. Pre-built binaries for Windows, Linux and Mac OS X are available from \download{rbutil/}. As \textsc{Rockbox Utility} is still under
  142. development more information including up-to-date download links can be
  143. found at \wikilink{RockboxUtilityQt}.
  145. \warn{When first starting \textsc{Rockbox Utility} run ‘Autodetect’, found in the configuration dialog (File > Configure). Autodetection
  146. 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
  147. the location of the \dap{} in your filesystem. On Windows, this is the drive
  148. letter the \dap{} gets assigned. On other systems this is a path in the
  149. filesystem.}
  150. \opt{ipodvideo}{\warn{Autodetection is unable to distinguish between the
  151.         \playerman{} 30~GB and 60~GB / 80~GB models, defaulting to the 30 GB model. This will usually work but you might want to check the
  152.         detected value, especially if you experience problems with Rockbox.}}
  154. \note{Rockbox Utility currently lacks some guiding messages. Please have a look at the manual installation instructions if you are stuck during installation.}
  156. \subsection{Manual Installation}
  158. \subsubsection{Choosing a Rockbox version}\label{sec:choosing_version}
  160. There are three different types of firmware binaries available from the Rockbox website:
  161. \label{Version}
  162. Release version, current build and daily build. You need to decide which one you want to install and get the appropriate version for your \dap{}.
  164. \begin{description}
  166. \item[Release.]
  167.   \opt{archos}{The release version is the latest stable release, free
  168.       of known critical bugs. The current stable release of Rockbox, version
  169.       2.5, is available at \url{}.
  170.   }
  171.   \opt{SWCODEC}{
  172.       There has not yet been a stable release for the \playername{}. Until there is one, use a current build.
  173.   }
  175. \item[Current Build.] The current build is built at each source code change to the Rockbox SVN 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. You can download the current build from 
  176.   \url{}.
  178. \item[Archived Build.] In addition to the release version and the current build,
  179.   there is also an archive of daily builds available for download. These are
  180.   built once a day from the latest source code in the SVN repository. You can
  181.   download archived builds from \url{}.
  183. \end{description}
  185. \nopt{player}{
  186.   \note{\index{Installation!Fonts}\label{sec:installing_fonts}
  187.     Rockbox has a fonts package that is available at
  188.     \url{} or from the \emph{extras} link in
  189.     the menu on the Rockbox website. While the current builds and
  190.     daily builds change frequently, the fonts package rarely changes. The fonts package is therefore not included in these builds. When installing Rockbox for the first time, you should install the fonts package. The release version, on the other hand, does not change, so fonts are included when you download a release.
  191.   }
  192. }
  194. \warn{Because current builds and daily builds are development versions which change frequently, they may behave differently than described in this manual, or they may introduce new (and maybe annoying) bugs. If you do not want to get undefined behaviour from your \dap{}, you should stick to the current stable release if there is one for your \dap{}. If you want to help with project development, you can try development builds and help by reporting bugs. Just be aware that these are development builds that are highly functional but not perfect!}
  196. \subsubsection{Installing the firmware}\label{sec:installing_firmware}
  198. \opt{sansa}{\warn{The following steps require you to change the setting in
  199.   \setting{Settings $\rightarrow$ USB Mode} to \setting{MSC} from within the
  200.   original firmware. Never extract files to your \dap{} while it is in
  201.   recovery mode.}}
  202. \opt{h10,h10_5gb}{\warn{The following steps require you to use UMS mode and so
  203.   may require use of the UMS trick as described in the bootloader installation
  204.   section.}}
  205. \opt{gigabeat}{\warn{During installation, do not connect your \dap{}
  206.   using the cradle but plug the USB cable directly to the \dap{}.}}
  207. \opt{ipodvideo}{\warn{There are separate versions of Rockbox for the 30GB and
  208.   60GB/80GB models.  You must ensure you download the correct version for your
  209.   \dap{}.}}
  211. \begin{enumerate}
  213. \item Download your chosen version of Rockbox from the links in the
  214.   previous section.
  216. \item Connect your \dap{} to the computer via USB
  217.   \opt{ipod3g,ipod4g,ipodmini,ipodcolor}{ or Firewire} to the computer via USB, as described in the manual that came with your \dap{}.
  219. \item Take the file that you downloaded and use the “Extract all” command of your unzip program to extract the files in the
  220.   \fname{.zip} file onto your \dap{}.
  222. \note{The entire contents of the \fname{.zip} file should be extracted directly to the root of your \daps{} drive. Do not try to
  223. create a separate directory or folder on your \dap{} for the Rockbox
  224. files! The \fname{.zip} file already contains the internal directory
  225. structure that Rockbox needs.}
  227. \end{enumerate}
  229. \opt{archos}{
  230.   \note{
  231.     If the contents of the \fname{.zip} file are extracted correctly, you will have a directory called \fname{.rockbox}  which contains all the files needed by Rockbox, in the main found in the bootloader
  233.     \daps{} drive, and also a folder called \fname{/.rockbox}, which contains a
  234.     number of other folders and system files needed by Rockbox. If you receive a
  235.      ``-1'' error when you start Rockbox, you have not extracted the contents of
  236.     the \fname{.zip} file to the proper location.
  237.   }
  238. }
  240. % This has nothing to do with swcodec, just that these players need our own
  241. % bootloader so we can decide where we want the main binary.
  242. \opt{SWCODEC}{
  243.   \note{
  244.     If the contents of the \fname{.zip} file are extracted correctly, you will
  245.     have a folder called \fname{/.rockbox}, which contains all the files needed
  246.     by Rockbox, in the main folder of your \daps{} drive. If you receive a
  247.     ``-1'' error when you start Rockbox, you have not extracted the contents of
  248.     the \fname{.zip} file to the proper location.
  249.   }
  250. }
  252. \opt{SWCODEC}{
  253.   \subsubsection{Installing the boot loader}
  254.   \opt{h1xx,h300}{\input{getting_started/iriver_install.tex}}
  255.   \opt{ipod}{\input{getting_started/ipod_install.tex}}
  256.   \opt{m5,x5}{\input{getting_started/iaudio_install.tex}}
  257.   \opt{h10,h10_5gb}{\input{getting_started/h10_install.tex}}
  258.   \opt{gigabeat}{\input{getting_started/gigabeat_install.tex}}
  259.   \opt{sansa}{\input{getting_started/sansa_install.tex}}
  260. }
  262. \subsection{Enabling Speech Support (optional)}\label{sec:enabling_speech_support}
  263. \index{Speech}\index{Installation!Optional Steps}
  264. If you wish to use speech support you will also need a voice file: English ones are available from \url{}.
  266. \begin{enumerate}
  267. \item Download the “voice” for your \dap{}.
  268. \item Rename it to \fname{english.voice}.
  269. \item Copy it into the \fname{langs} directory inside the \fname{.rockbox} directory on your \dap{}.
  270. \item Reboot.
  271. \end{enumerate}
  273. \note{Voice menus are turned on by default. See
  274. \reference{ref:Voiceconfiguration} for details on voice settings.}
  276. \section{Running Rockbox}
  277. Remove your \dap{} from the computer's USB port. %
  278. \nopt{ipod,e200}{Unplug any connected power supply and turn the unit off. When
  279. you next turn the unit on, Rockbox should load. }%
  280. \opt{ipod}{Reboot the Ipod by holding
  281.   \opt{IPOD_4G_PAD}{\ButtonMenu{}+\ButtonSelect{}}%
  282.   \opt{IPOD_3G_PAD}{\ButtonMenu{}+\ButtonPlay{}}
  283.   for a couple of seconds or so. Now Rockbox should load.
  284. } %
  285. \opt{e200}{Your e200 will automatically reboot and Rockbox should load. }%
  286. When you see the Rockbox splash screen, Rockbox is loaded and ready for
  287. use.
  289. \opt{ipod}{
  290.   \note{
  291.     Rockbox starts in the \setting{File Browser}. If you have loaded music onto your \dap{} using Itunes, you will not be able to see your music. This is because Itunes changes your files’ names and hides them in directories in the \fname{Ipod\_Control} directory. Files placed on your \dap{} using Itunes can be viewed by initializing and using Rockbox’s database. See section \reference{ref:database} for more information.
  292.   }
  293. }
  295. \section{Updating Rockbox}
  296. It is easy to update Rockbox, even without using Rockbox Utility.
  297. Download a Rockbox build.
  298. (The latest release of the Rockbox software will always be available from
  299. \url{}). Unzip the build to the root directory
  300. of your \dap{}, as you did in the installation stage. If your unzip
  301. program asks you whether to overwrite files, choose the ``Yes to all'' option.
  302. The new build will be installed over your current build.
  304. \note{If you use Rockbox Utility, be aware that it cannot detect manually
  305.         installed components.}
  307. \section{Uninstalling Rockbox}\index{Installation!uninstall}
  308. \subsection{Automatic Uninstallation}
  309. You can uninstall Rockbox automatically by using Rockbox Utility. If you
  310. installed Rockbox manually you can still use Rockbox Utility for uninstallation
  311. but won't be able to do this selectively.
  313. \opt{h1xx,h300}{\note{Rockbox Utility can't uninstall the bootloader due to
  314. the fact that it requires a flashing procedure. To uninstall the bootloader
  315. completely follow the manual uninstallation instructions below.}}
  317. \subsection{Manual Uninstallation}
  318. \opt{archos}{
  319.   If you would like to go back to using the original \playerman{} software,
  320.   connect the \dap{} to your computer, and delete the
  321.   \fname{\firmwarefilename} file.
  322. }
  323. \nopt{gigabeat,m5,x5,archos}
  324.   {
  325.   \note{The Rockbox bootloader allows you to choose between both Rockbox and the original firmware.
  326.   (See \reference{ref:Dualboot} for more information.)}}
  328. \opt{h10,h10_5gb}{
  329.   If you would like to go back to using the original \playerman{} software,
  330.   connect the \dap{} to your computer, and delete the
  331.   \opt{h10}{\fname{H10\_20GC.mi4}}\opt{h10_5gb}{\fname{H10.mi4}} file and rename
  332.   \fname{OF.mi4} to \opt{h10}{\fname{H10\_20GC.mi4}}\opt{h10_5gb}{\fname{H10.mi4}}
  333.   in the \fname{System} directory on your \playertype{}. As in the installation,
  334.   it may be necessary to first put your device into UMS mode.
  335. }
  337. \opt{e200}{
  338.   If you would like to go back to using the original \playerman{} software,
  339.   connect the \dap{} to your computer, and follow the instructions to install
  340.   the bootloader, but when prompted by sansapatcher, enter 'u' for uninstall,
  341.   instead of 'i' for install. As in the installation, it may be necessary to
  342.   first put your device into UMS mode.
  343. }
  345. \optv{ipod}{
  346.   To uninstall Rockbox and go back to using just the original Ipod software: Connect the \dap{} to your computer and follow the instructions to install the bootloader but, when prompted by ipodpatcher, enter ’u’ for uninstall, instead of ’i’ for install.
  347. }
  349. \opt{m5,x5}{
  350.   If you would like to go back to using the original \playerman{} software,
  351.   connect the \dap{} to your computer, download the original \playername{}
  352.   firmware from the \playerman{} web site. And copy it to the \fname{FIRMWARE}
  353.   directory on your \playername{}. Turn off the \dap{}, remove the USB cable
  354.   and insert the charger. The original firmware will automatically be flashed.
  355. }
  357. \opt{h1xx,h300}{
  358.   \note{
  359.     If you want to remove the Rockbox bootloader, simply flash an unpatched
  360.     \playerman{} firmware. Be aware that doing so will also remove the boot
  361.     loader USB mode. As that mode can come in quite handy (especially when
  362.     having disk errors) it is recommended to keep the boot loader. It also
  363.     gives you the possibility of trying Rockbox anytime later by simply
  364.     installing the distribution files.
  365.     \opt{h1xx}{
  366.       The Rockbox bootlaoder will automatically start the original firmware if
  367.       the \fname{.rockbox} folder has been deleted.
  368.     }%
  369.     \opt{h300}{%
  370.       Although if you retain the Rockbox boot loader, you will need to hold the
  371.       \ButtonRec{} button each time you want to start the original firmware.
  372.     }
  373.   }
  374. }
  376. If you wish to clean up your disk, delete the \fname{.rockbox} directory.
  377. }

Update the Post

Either update this post and resubmit it with changes, or make a new post.

You may also comment on this post.

update paste below
details of the post (optional)

Note: Only the paste content is required, though the following information can be useful to others.

Save name / title?

(space separated, optional)

Please note that information posted here will expire by default in one month. If you do not want it to expire, please set the expiry time above. If it is set to expire, web search engines will not be allowed to index it prior to it expiring. Items that are not marked to expire will be indexable by search engines. Be careful with your passwords. All illegal activities will be reported and any information will be handed over to the authorities, so be good.

comments powered by Disqus