Rockbox Utility

• Latest Release: 1.2.2
• Released: 2009-06-17
• Platform: Windows (2000 / XP / Vista), Linux, OS X

This is the automated installer tool for Rockbox. A quickstart guide can be found at GraphicalInstall -- this only covers first time installation, but should give you a fairly good idea how it works. If you have any problems, please read the changelog and issues list on the development page page before reporting any bugs!

NOTE: The themes site http://themes.rockbox.org is still very new and is not populated with very many themes. You need at least Rockbox Utility 1.2.1 to install themes from themes.rockbox.org from within Rockbox Utility. Also, you may wish to install themes manually from the WpsGallery until the new themes site is more populated.

Features

This section lists all features rbutil currently has.

• Base
  • Bootloader installation
  • Rockbox installation
• Extras
  • Fontpack installation
  • Theme installation
  • Game files installation (ie freedoom)
• Accessibility
  • Install voice file (from the webpage)
  • Create voicefile
  • Create .talk clips
• Uninstallation
  • Uninstall bootloader
  • Uninstall Rockbox ( partial, or full)
• Manual
  • Access to the Manual of your device
• Info
  • Shows all installed parts of Rockbox

Download

Platform	Version	URL
Windows	1.2.2	http://download.rockbox.org/rbutil/win32/rbutilqt-v1.2.2.zip
Mac OS X	1.2.2	http://download.rockbox.org/rbutil/macosx/rbutilqt-v1.2.2.dmg
Linux (32 bit x86)	1.2.2	http://download.rockbox.org/rbutil/linux/rbutilqt-v1.2.2.tar.bz2
Linux (64 bit x86)	1.2.2	http://download.rockbox.org/rbutil/linux/rbutilqt-v1.2.2-linux_x86_64bit.tar.bz2
Source	1.2.2	http://download.rockbox.org/rbutil/source/rbutil-1.2.2.tar.bz2

You can browse all available downloads starting at http://download.rockbox.org/rbutil/

There is also a user contributed Gentoo ebuild of current SVN available, which may or may not be up-to-date: http://www.rockbox.org/twiki/bin/viewfile/Main/RockboxUtility?rev=3;filename=rbutil-9999.ebuild

Rockbox Utility runs on Windows (2000, XP), Mac OS X and Linux. Older versions of Windows (98, 95) are not supported -- Rockbox Utility uses some windows functionality that has been added starting with 2000. Windows Vista is currently only slightly tested due to the lack of a test setup and might have additional issues. Please join us on IRC if you can help out.

Known issues

The following is a list of known issues in the current release (1.2.2):

• E200R isn't supported by rbutil. The Bootloader install differs from e200.
• Ipod Video 64MiB (60 GB / 80 GB models) will get detected as Video 32MiB (30 GB) (which is safe).
• (OS X) Complete / Small Install is not working correctly for Sansa / Apple players: bootloader installation unmounts the player (required), but the build gets installed before the system can remount the player. You need to use the separate installs from the "Installation" tab for now.

Please do not report bugs here -- this list is intended to hold known and verified issues. For reporting bugs please use the tracker as this also allows us to get back into contact with you.

Screenshots

Main Window (Windows)

Setings Dialog (Windows)

Installation Dialog (Linux)

Theme Dialog (Windows)

Change Log

Bug fixes are marked with a . Improvements are marked with a .

• svn (upcoming release)
  • (none yet)

• 1.2.2 (bugfix release) released 2009-06-17
  • (all) UI for Encoder and TTS settings was reworked (FS#10070).
  • (all) Bootloader installation now respects the selected mountpoint when installing the bootloader on ipod and sansa players (FS#10096).
  • (all) fix a segfault on exit when bootloader installation was called multiple times (only ipod / sansa bootloader)
  • (all) fix proxy support not working properly with theme installation (and probably other dialogs)
  • (all) fix various broken links (most notably manual and voice file download), resulting in a "HTTP 404" error.

• 1.2.1 (bugfix release) released 2009-04-26
  • (all) Theme installation doesn't find themes, because the theme site changed
  • (all) For some targets (iriver h10 5gb, ipod mini) the target mismatch detection doesn't work correctly (FS#10055).
  • (all) installing the bootloader on Sansa players could result in a wrong bootloader installed if the selected device didn't match the physically present one (i.e. e200 bootloader installed on c200).
  • (all) zip files created by info-zip 3.0 not extracted properly, no error indication.
  • (linux) The Festival TTS is now supported under Linux (FS#9983).

• 1.2 (themes.rockbox.org ready) - released 2009-03-23
  • (w32) selecting a cache path was limited to drives (FS#10013).
  • (all) themes dialog doesn't show any themes even if there are themes available (Note: the themes site isn't up yet).
  • (all) improved error reporting on theme preview download.

• 1.1 (no more hardcoded release) - released 2009-03-06
  • (all) Rockbox Utility now retrieves information about the latest Rockbox release from the download server.
  • (all) The configuration is now checked in the configuration dialog before accepting it to prevent wrong configurations getting saved (FS#9944).
  • (linux) try to detect if Rockbox Utility is run using sudo and make sure the configuration file (on the PC) is saved with proper permissions.
  • (w32) "No Sansa found" error when trying to install the bootloader for e200 / c200 (FS#9729).

• m1.0.9 (bugfix release) - released 2009-01-06
  • (all) Gigabeat F/X bootloader installation put the bootloader file in the wrong place (FS#9766)

• m1.0.8 ("Rockbox 3.1" release) - released 2008-12-23 with Rockbox 3.1
  • rbutil now checks if the disk space is sufficient before extracting zip files (fixes FS#9417).
  • bootloader installation has been reworked completely, improving the messages during bootloader install and adding more hints (i.e. where to find required files etc.)
  • installation dialog now remembers the last build selection
  • quick start defaults to the latest release instead of the most recent build.
  • support for Rockbox 3.1
  • (w32) sapi voice engine support was broken. (Updated binaries available as m1.0.7b)

• m1.0.7 (bugfix and "3.0 ready" release) - released 2008-09-26
  • if no language has been selected by the configuration the system language is used (given that a translation in the system language is available)
  • support for sansa c200 with original firmware version 01.01.07
  • rbutil now transmits its own User-Agent string for http requests.
  • replaced "Install All" button in theme installation by a notice how to install multiple themes.
  • Bootloader installation for iaudios could fail if there is no FIRMWARE directory
  • update for Rockbox 3.0 release

• m1.0.6 (bugfix release) - released 2008-07-06
  • Rbutil now asks if it should backup before updating to a new Build.
  • improved download caching
  • new System Info dialog (About / System Info). Shows user priviledge level on W32, so check this if you have issues installing the bootloader on your Ipod / Sansa.
  • the encoder is now automatically choosen depending on the selected player.
  • (w32) improved mountpoint detection for Sansa / Ipod.
  • (w32) using autodetection resulted in "no Sansa found" errors.

• m1.0.5 (bugfix release) - released 2008-04-21
  • (linux, os x) H10, Iaudio, Gigabeat and m:robe bootloader installation can fail on case-sensitive systems
  • (regression) System proxy setting isn't honored in some places.
  • Themes button created a segfault when offline mode was enabled.
  • mountpoint detection on Gigabeat was non-functional.
  • downloading didn't work if URI contained special characters (happened with a space in DockPod Aqua theme file)
  • enhanced mountpoint detection for Ipods. Should work always if OF specific folders are present.
  • m:robe 100 support.
  • iaudio m3 support.
  • detect unsupported player variants (e200v2 / c200v2 / Ipod Nano 2G / 3G) and inform the user that Rockbox will not run.
  • extracting the downloaded archives previously didn't show any progress (most notably on players with slow hard discs like m:robe)

• m1.0.4 (bugfix release) - released 2008-02-19
  • Complete Installation still seems buggy. Please use the install options from the second tab, until it's fixed.
  • The URL to the voice file was wrong for a few targets.
  • (w32 / vista) bootloader installation doesn't work due to UAC issues on windows vista, you need to use the manual bootloader installation for now.
  • Voice file creation is now possible with rbutil.
  • Support rbspeex as encoder for .Talk files. Its now builtin.
  • (w32) Sapi_voice script is now built in.
  • (w32) "system proxy" now also honors the ProxyEnable value (i.e. if you entered a proxy value in IE's settings dialog but disabled them rbutil also won't use them. Automatic proxy settings are still unsupported).

• m1.0.3 (bugfix release) - released 2007-11-13.
  • Talkfile creation puts the _dirname.talk file in the wrong place.
  • complete Installation failed with "unsupported install method".
  • (w32) Sansa bootloader installation didn't work

• m1.0.2 (bugfix release) - released 2007-10-18.
  • Enhanced device detection code, utilizing the USB IDs.
  • Two new translations (Chinese traditional and simplified.
  • Support for the sansa c200.
  • On Windows using the proxy settings set in IE5 is supported.
  • The new "Actions" menu should make it easier to operate using the keyboard or screenreaders.
  • uninstalling the bootloader doesn't honor the proxy setting
  • Iaudio M5 was listed as color target
  • add Sandisk C200 configuration and detection
  • installation tasks don't check for a valid configuration but fail instead.
  • small / complete installation tries to install the bootloader even for targets that don't require one; similar applies to doom.
  • downloading PDF manual crashes installer

• m1.0.1 (bugfix release) - released 2007-09-03.
  • Enhanced device detection code. (Note: The user configuration file changed slightly. If you used Rockbox Utility before your user configuration is expected to be missing upon the first launch.)
  • when you use the autodetection button, a device was found by the detection and there wasn't anything selected previously the program segfaults.
  • the ipodvideo64mb build was missing. ipodpatcher cant detect it, select it by hand.
  • rbutil doesnt detect and install the iaudio X5V build correctly
  • when detecting a device only the selected tree was collapsed.
  • the install log window doesn't update between download started and unzip finished.
  • entering the talk file window with invalid settings result in a crash. Strangely doesn't happen in all cases.
  • (linux only) when autodetecting an Ipod there was a possiblity to detect the wrong mountpoint if other partitions (IPL) are present and mounted
  • (w32 only) the menu bar shows up slightly delayed (looks like this was related to my Qt installation and not a bug itself)
  • (w32 only) if you close the program while it tries downloading build information (from the main screen) you'll get a crash upon exit

• m1.0 (Milestone 1) - released 2007-08-29.
  • All functionality that was present in the old version has been ported, plus some minor enhancements.

Development

CategoryFrontpage: The Rockbox Installer and Housekeeping Utility [Misc]