Rockbox Tagcache Database Generator

April 11th, 2011 Leave a comment Go to comments

This package provides a very simple tool that generates a set of Rockbox Tagcache database files. Based in large part on the documentation in the Rockbox wiki, this tool can be useful in cases where the on-device Rockbox database creation function is failing for some unexplained reason.

This is a very simple command-line tool that is configured via a properties file. Thus, this is a pretty geeky tool and not necessarily well targeted to non-technical people.


Executing the Tool

Configuration Properties

Generation configuration is specified via a Java properties file with the following properties:

Property Description Example
host.endian Set the proper endianness for the host machine, as the database is stored according to the host’s endianness. Which is big endian for coldfire and SH1, and little endian for ARM. host.endian=little
file.match.expression Set an appropriate regular expression to match the types of files you want added to the database. This expression should be set up to match including the path. file.match.expression=.*\\.mp3 The folder for the database to be written. This could be direct to the Rockbox (.rockbox) folder or an intermediate folder.
media Specify a comma-separated list of the available media. As implemented, it is assumed that there is only internal (mapped to root) or external (mapped to <microSD1>) media. media=internal,external
media.internal Location (when mounted) to find the internal media in the PC’s file system. media.internal=/media/FUZEV2
media.external Optional location (when mounted) to find the external media in the PC’s file system. media.external=/media/16G MICROSD

Command-line Launch

The tool is packaged as an executable JAR file that can be launched via the command-line. This tool requires a Java Runtime Environment to be installed on your system. From the command-line, enter

java rockboxtagcache.jar -jar <path-to-config-properties>

to start the tool’s Rockbox tagcache database generation.

Target File Location

The files generated by the tool must be placed in /path/to/player/.rockbox in order for the player to find them. Restart the player to load this new database.

License and Disclaimer

This free software program may be freely distributed under the terms of the Apache Software License, Version 2.0, provided that no charge above the cost of distribution is levied, and that the disclaimer below is always attached to it.

The programs are provided as is without any guarantees or warranty. Although the author has attempted to find and correct any bugs in the free software programs, the author is not responsible for any damage or losses of any kind caused by the use or misuse of the programs. The author is under no obligation to provide support, service, corrections, or upgrades to the free software programs.

  1. No comments yet.