release
dev builds
extras
themes manual
wiki
device status forums
mailing lists
IRC bugs
patches
dev guide



Search | Go
Wiki > Main > RockboxUtility

Rockbox Utility

Main Window
  • Latest Release: 1.5.1
  • Released: 2022-04-18
  • Platform:
    • Windows (7 / 8 / 10)
    • Linux
    • OS X (10.11 and up, x86_64)


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!


Having issues with Rockbox Utility? Please check the frequently asked questions RockboxUtilityFaq page before asking for help.

Features

This section lists all features Rockbox Utility currently has.

  • Base
    • Bootloader installation
    • Rockbox installation
  • Extras
    • Fontpack installation
    • Theme installation
    • Game files installation (i.e. 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

Rockbox Utility is available for Windows, Mac OS X and Linux. Please note the following:

  • Older versions of Windows (e.g. 9X, ME) are not supported -- Rockbox Utility uses some Windows functionality that has been added starting with 2000. The provided binary only runs on Windows 7, 8 and 10.
  • On Windows you might see a warning coming from Windows Defender SmartScreen. To continue,
    • Click "More info"
    • Click "Run anyway" which will then appear at the bottom of the warning.
  • Rockbox Utility is built as a 64bit x86 application on Mac OS X. It requires at least OS X 10.12.
  • For Linux, any modern distro should work.
  • The ARM64/aarch64 build for Linux is for use on any ARM64-based computer running a 64-bit Linux distro (e.g. Raspberry Pi 4, Pinebook Pro, etc.).

Platform Version URL
Current Version
Windows 1.5.1 zip https://download.rockbox.org/rbutil/win32/RockboxUtility-v1.5.1.zip
Mac OS X 1.5.1 else https://download.rockbox.org/rbutil/macosx/RockboxUtility-v1.5.1.dmg
Linux (64-bit x86) 1.5.1 zip https://download.rockbox.org/rbutil/linux/RockboxUtility-v1.5.1.AppImage
Source 1.5.1 zip https://download.rockbox.org/rbutil/source/RockboxUtility-v1.5.1-src.tar.bz2
Older Versions
Linux (32 bit x86) 1.4.0 zip https://download.rockbox.org/rbutil/linux/RockboxUtility-v1.4.0.tar.bz2
Linux (64 bit x86) 1.4.1 zip https://download.rockbox.org/rbutil/linux/RockboxUtility-v1.4.1-64bit.tar.bz2
Linux (ARM64/aarch64) 1.4.1 zip https://download.rockbox.org/rbutil/linux/RockboxUtility-v1.4.1-aarch64.tar.gz

Note: Not all platforms have the latest Rockbox Utility released for technical reasons.
If the links in the table do not link to the latest version the binaries haven't been uploaded yet. Do not file bug reports against such a case, the release process involves multiple people and thus can take a while.

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

Packages

We do not provide binary packages of Rockbox Utility except the binaries in the table above. If you maintain a package for a distribution you can add it to the table below. If you do so please update the table when updating the package. Thanks.

WARNING: we do not support these packages!

Platform Version URL
Arch Linux 1.4.0 else rbutil is available in the [community] repository
Gentoo 1.4.1 else https://packages.gentoo.org/packages/app-misc/rbutil
Ubuntu 1.4.0 else available via GetDeb repository. See also UbuntuHandbook on how to install it.
Ubuntu 1.4.1 else https://launchpad.net/~benjaoming/+archive/ubuntu/rockbox

Known issues

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

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

some screenshot of RockboxUtility 1.3.0. RockboxUtility looks similar on all platforms due to the used toolkit. The appearance follows the settings of your operating system. Note: Theming is done by Qt using plugins, which has limitations with statically linked binaries. The binaries provided on this page are statically linked for your convenience, this means that when using a theme that is not part of Qt it won't get loaded and might result in a different look than your desktop. This issue usually only appears on Linux.

Main Window
Main Window
(Windows 7)
rbutil1.png
Configuration Dialog
(Windows 7, german translation)
snapshot3.png
Theme selection Dialog
(Linux)
Theme Installation Dialog
Talkfile creation dialog
(Mac OS X)

 

Change Log

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

  • development (git only)

  • 1.5.1 - released 2022-04-18
    • DONE (win) Fix bootloader installation for Ipods.
    • DONE (win) Fix bootloader installation for Sandisk players.
    • (all) Improve responsiveness on install / uninstall.
    • (all) Enable Themes installation if themes are selected.

  • 1.5.0 - released 2022-03-27
    • (all) Add support for xDuuo X3, X3ii, X20.
    • (all) Add support for AGPTek Rocker.
    • (all) Add support for AIGO Eros Q and various clones (AIGO Eros K, AGPTek H3, HIFI Walker H2, Surfans F20)
    • (all) Update bootloaders for Iriver H100 and H300 series.
    • (all) Extend game file installation to support further games and further plugins (PluginMidiPlay) and rename to Plugin Data.
    • (all) Support installing daily builds.
    • (all) Support installing voice files for daily builds and releases in all languages available for download.
    • (all) Add support for showing "retired" target status.
    • (all) Improve HiDPI support.
    • (all) Update various libraries, most notably now requires Qt5.

  • 1.4.1 - released 2019-11-15 (for 64-bit Linux and Windows only
    • (all) Support for mks5lboot installation (iPod 6G)
    • DONE (all) Fix crash when detecting a supported player in MTP mode.

  • 1.4.0 (new player detection) - released 2014-01-05
    • (all) Rework player detection functionality to provide better results.
    • (all) Limit mountpoints ("Select your device in the filesystem") in configuration dialog to usable ones.
    • (all) Change encoder volume configuration to allow more sensible values.
    • (all) Save proxy password differently in configuration file (better solution for FS#12166).
    • (all) Add support for building Rockbox Utility with Qt5.
    • (all) Add support for extracting Original Firmware files compressed with CAB (G#418).
    • (all) Add support for Creative Zen X-Fi3 (G#419).
    • (all) Add Changelog window.
    • (all) Rework System Trace functionality.
    • (all) Add support for H300 v1.31K firmware.
    • (all) Add support for Clip Zip v01.01.21 firmware.

  • 1.3.1 (bugfix release) - released 2012-11-25
    • DONE (all) Fix first time installation always trying to install the bootloader on devices without a bootloader.
    • DONE (all) Fix problem with generating talk files (FS#12748).
    • DONE (all) Fix manual URLs not getting updated properly on device change.
    • (w32) Add button to safely eject the player.
    • (w32) Add support for MS Speech Platform.

  • 1.3.0 (no more Quickstart release) - released 2012-09-02
    • DONE (all) Fix crash in mkimxboot based bootloader patching, caused by changes in mkimxboot.
    • DONE (Linux, OS X) Fix command line espeak and flite failing on "-inf" voice string
    • DONE (all) Fix talkfile dialog not remembering additional options (FS#12634).
    • DONE (all) Fix bootloader file not found in zip archive in some cases.
    • DONE (all) Add missing bootloader filenames for c200v2.
    • (all) Support retrieving voice strings from installation (only available for recent versions)
    • (all) Allow selecting multiple folders when generating talkfiles.
    • (all) Support installing official release candidate builds.
    • (all) Add dedicated backup dialog. Backup functionality will archive the .rockbox folder on the player into a zip file, allowing to easily restore it later (Rockbox Utility doesn't support restoring yet, but this is as simple as extracting a zip)
    • (all) add Ipod Classic (disabled in the configuration)
    • (all) replace Quick Start and Extras tab with a completely reworked Installation tab
    • (all) rework selected device display in main dialog and display player icon.

  • 1.2.14 (bugfix release) - released 2012-06-03
    • DONE (all) Fix some development build git version numbers being recognized as release, leading to the wrong fonts / manual being downloaded.
    • DONE (all) Fix HTML manual download link.
    • DONE (all) H100, H300: don't silently fail to copy the firmware to the file if a firmware file is already present.
    • DONE (all) Fix "no mountpoint given" when preselected mountpoint wasn't changed.
    • DONE (all) Remove < and > from voice strings. Fixes problems with SAPI creating empty files, resulting in voicefile generation to fail.
    • DONE (all) Check result of copy operation during bootloader installation, which could fail silently (all players that use "file" and "mi4" bootloader installation)
    • DONE (all) Fix a problem extracting zip files (reported on the forums)
    • (all) Enabled support for MPIO HD200 and HD300
    • (all) Add missing languages basque and english-us for voicefile generation
    • (all) Use filter in file chooser dialog when opening original firmware file (all players that require an original firmware file during bootloader installation)
    • (all) Remove support for archived builds (previously "daily") and voice files. Users should install a development build instead, and voice files can be created with Rockbox Utility.

  • 1.2.13 (bugfix release) - released 2012-03-06
    • DONE (w32) Fix bootloader installation for Fuze+ "crashing".
    • DONE (all) Fix crash when dismissing the encoder properties with "Ok" when libmp3lame is not found.
    • DONE (all) Fix wrong URLs when downloading the manual (FS#12587, regression from FS#12346).
    • DONE (all) Handle git version information of an installed build correctly via rockbox-info.txt. Fixes font pack download failing.
    • DONE (w32) Fix syncronisation problem with SAPI voice generation causing voicefile generation to fail (FS#12595).

  • 1.2.12 (bugfix release) - released 2012-02-06
    • (all) support for mkimxboot bootloader installation (used by Fuze+)
    • (all) Support enabled for
      • Fuze+
      • Clip Zip
    • (all) recognize Ipod Nano 6G as unsupported device
    • (w32, linux) use libmp3lame for encoding voice clips for Archos devices. Huge speedup on Windows, small speedup on Linux (currently not enabled for OS X)
    • (all) support reading original firmware files in zip format.
    • (all) Boot Rockbox on USB insert rather then the Sandisk firmware on ClipV2, FuzeV2, Clip+, and Clip Zip.
    • DONE (all) Includes mkamsboot 1.6 to fix installing on some hardware variants of the Clip V2.
    • DONE (all) wavtrim (silence threshold) setting value was ignored when creating voicefiles.
    • DONE (all) remove multithreading support for voicefile / talkfile generation to fix generation problems (FS#12106). Note: this intentionally slows down generation!

  • 1.2.11 (bugfix release) - released 2011-11-06
    • DONE (all) Proxy username / password caused problems when containing colon and at signs (FS#12166)
    • DONE (all) Gigabeat F/X bootloader uninstallation stopped with an error saying it's not supported.
    • DONE (all) Manual URL was wrong in some cases (FS#12346).
    • (all) Support Newer Sandisk Clip+ firmware.
    • (all) Mountpoint selection has been reworked and now shows more information.
    • (all) support for voicefile string corrections (like voice.pl does). This is currently limited to a fixed list of corrections and voicefile creation and can be disabled in the TTS configuration.
    • (all) changing the application language doesn't require a restart anymore.
    • (w32) improve window icon for high resolutions (large icons in Vista / W7 taskbar)
    • (all) add support for
      • GoGear SA9200 (currently disabled)
      • Sansa Fuze+ (currently disabled)
      • Sansa Clip Zip (currently disabled)

  • 1.2.10 (bugfix release) - released 2011-05-08
    • DONE (w32) use different build setup to work around NVDA, probably other screen readers, not speaking the UI anymore (FS#12089)
    • (all) Add slovak to languages (FS#10904)
    • (all) Support an optional build ID in version handling.

  • 1.2.9 (bugfix release) - released 2011-04-30
    • DONE (all) fix Sansa c200v2 not showing up in the device selection dialog
    • DONE (OS X) fix a crash on proxy detection (FS#11654).
    • DONE (all) fix encoding issue in System Log.
    • DONE (all) replace OSDaB zip with QuaZip. Fixes zip file created with recent tools not extracting properly without notice (iLike theme is known to be affected).
    • DONE (w32) workaround for sporadic failures when creating voicefile on Windows with SAPI voices.
    • DONE (w32) correct the default speed value for SAPI TTS to be unusable
    • (all) improve automatic language preselection (in case no language has been set explicitly) in voice file creation dialog
    • (all) improve feedback during TTS test
    • (all) add latvian to languages for voicefile creation
    • (all) show item for detected player in bold in the configuration dialog
    • (all) add support for
      • Philips GoGear HDD16x0, HDD18x0, and HDD63x0 series
      • MPIO HD300 (currently disabled)

  • 1.2.8 (bugfix release) - released 2010-09-23
    • DONE (all) fix regression in Rockbox Utility version check (appearing on 64bit Linux) (FS#11439)
    • (all) merge Ipod Video 64MB and 32MB builds.
    • (OS X) Use IOKit for USB enumeration instead of libusb
    • (OS X) Add option to build Intel only binaries (default is still fat binaries)
    • (all) Add support for some Fuze V2 and Clip+ hardware revisions that could not be patched due to changed firmware format

  • 1.2.7 (bugfix release) - released 2010-06-22
    • DONE (all) fix proxy support getting initialized too late, resulting in error messages on startup (FS#11163).
    • DONE (all) Distinguish between release and daily build when installing voice file and fonts. Fixed file mismatches (FS#11362).
    • DONE (linux) Fix a crash on USB detection (FS#11420).
    • (all) Multicore support for TTS and encoders (FS#11160)
    • (all) improve detection of new RockboxUtility version (false positive was showing up on Mac only).
    • (all) handle Rockbox install versions when installing themes. Fixes incompatible themes getting installed after the recent theme syntax change.
    • (all) new targets support
      • Sansa Fuze v2
      • MPIO HD200 (FS#11242) (disabled)

  • 1.2.6 (bugfix release) - released 2010-04-10
    • DONE (all) fix bootloader installation problem for H10 (might occur on m:robe 100 too; FS#11086).
    • DONE (all) fix manual download links for H10.
    • DONE (OSX) fix voice and talk file creation on PPC
    • (OSX) support for Speech Synthesis Manager
    • (OSX) support system proxy values retrieval
    • (all) rename the binary from "rbutilqt" to "RockboxUtility".
    • (linux) replace bitmap icon with svg version (FS#11094).
    • (all) new targets
      • sansa clip+
      • clipv2
      • Packard Bell Vibe500
      • Toshiba Gigabeat S (disabled)

  • 1.2.5 (bugfix release) - released 2010-02-12
    • DONE (w32) ipod bootloader install was broken
    • DONE (OSX) released binary was wrongly built.
    • (all) allow showing disabled targets in configuration dialog

  • 1.2.4 (bugfix release) - released 2010-02-03
    • (all) Support for 2nd generation Ipod Nano
    • (all) Support for Cowon D2 (FS#10728) (currently disabled)
    • DONE (all) The language selected for talkfile creation overwrote the system language
    • (all) Change layout direction according to language
    • (all) Detect Ipod 64MB
    • DONE (OSX) Fix WinPod misdetected as MacPod on OS X (FS#9833).
    • DONE (OSX) Fix bootloader installation for Sansa players.
    • DONE (OSX) Wait for the system to remount the player after bootloader installation. Fixes small / complete installation writing data to the wrong location (FS#10100).

  • 1.2.3 (bugfix release) - released 2009-09-20
    • DONE (all) Talkfile window: don't overwrite the current selected path with the previous value when changing settings from the dialog directly (FS#10409).
    • (all) (preliminary) support for Samsung YH-820, YH-920 and YH-925 (FS#10373). (currently disabled)
    • (all) (preliminary) support for Sansa AMS models (e200v2, fuze, m200v4, clip). (FS#10185). (m200v4 and clip currently disabled)
    • (all) (preliminary) support for ChinaChip models (Onda VX747(+), VX777). (FS#10456).(currently disabled)
    • (all) log internal state add possibility to save it upon error from the log window, and (regardless of an error occured) view and save it from the menu.
    • DONE (all) don't internally select a player model if an unsupported player is detected.
    • DONE (all) Festival TTS handling was broken in version 1.2.2
    • (all) new option to ignore specific files for .talkfile generation
    • DONE (all) Rockbox Utility didn't properly follow redirects on the server
    • (all) Add check for new Rockbox Utility version at startup
    • DONE (all) update several URLs to match the new locations after the server move.
    • DONE (all) Rockbox Utillity could not generate voice files for releases.

  • 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).
    • DONE (all) fix a segfault on exit when bootloader installation was called multiple times (only ipod / sansa bootloader)
    • DONE (all) fix proxy support not working properly with theme installation (and probably other dialogs)
    • DONE (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
    • DONE (all) Theme installation doesn't find themes, because the theme site changed
    • DONE (all) For some targets (iriver h10 5gb, ipod mini) the target mismatch detection doesn't work correctly (FS#10055).
    • DONE (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).
    • DONE (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
    • DONE (w32) selecting a cache path was limited to drives (FS#10013).
    • DONE (all) themes dialog doesn't show any themes even if there are themes available ( Note: the themes site isn't up yet).
    • DONE (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.
    • DONE (all) The configuration is now checked in the configuration dialog before accepting it to prevent wrong configurations getting saved (FS#9944).
    • DONE (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.
    • DONE (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
    • DONE (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.
    • DONE support for Rockbox 3.1
    • DONE (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.
    • DONE Bootloader installation for iaudios could fail if there is no FIRMWARE directory
    • DONE 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.
    • DONE (w32) using autodetection resulted in "no Sansa found" errors.

  • m1.0.5 (bugfix release) - released 2008-04-21
    • DONE (linux, os x) H10, Iaudio, Gigabeat and m:robe bootloader installation can fail on case-sensitive systems
    • DONE (regression) System proxy setting isn't honored in some places.
    • DONE Themes button created a segfault when offline mode was enabled.
    • DONE mountpoint detection on Gigabeat was non-functional.
    • DONE 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
    • DONE Complete Installation still seems buggy. Please use the install options from the second tab, until it's fixed.
    • DONE The URL to the voice file was wrong for a few targets.
    • DONE (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.
    • DONE Talkfile creation puts the _dirname.talk file in the wrong place.
    • DONE complete Installation failed with "unsupported install method".
    • DONE (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.
    • DONE uninstalling the bootloader doesn't honor the proxy setting
    • DONE Iaudio M5 was listed as color target
    • DONE add Sandisk C200 configuration and detection
    • DONE installation tasks don't check for a valid configuration but fail instead.
    • DONE small / complete installation tries to install the bootloader even for targets that don't require one; similar applies to doom.
    • DONE 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.)
    • DONE when you use the autodetection button, a device was found by the detection and there wasn't anything selected previously the program segfaults.
    • DONE the ipodvideo64mb build was missing. ipodpatcher cant detect it, select it by hand.
    • DONE rbutil doesnt detect and install the iaudio X5V build correctly
    • DONE when detecting a device only the selected tree was collapsed.
    • DONE the install log window doesn't update between download started and unzip finished.
    • DONE entering the talk file window with invalid settings result in a crash. Strangely doesn't happen in all cases.
    • DONE (linux only) when autodetecting an Ipod there was a possiblity to detect the wrong mountpoint if other partitions (IPL) are present and mounted
    • DONE (w32 only) the menu bar shows up slightly delayed (looks like this was related to my Qt installation and not a bug itself)
    • DONE (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

Development information have been moved to RockboxUtilityDevelopment.

If you need a more up-to-date version of RockboxUtility you can try a binary build from current code. Important: those binaries are not supported. Please do not file bug against such binaries. If you have issues with them please tell us using our support channels. Also, those binaries are not updated regularly so they might not be newer than the latest release!

CategoryFrontpage: The Rockbox Installer and Housekeeping Utility [Misc]

r335 - 19 Apr 2022 - 07:30:57 - DominikRiebeling

Copyright © by the contributing authors.