Rockbox Tagcache Database Generator
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.
Downloads
- Binary Tool – rockboxtagcache.jar .
- Sources Archive – rockboxtagcache-src.zip .
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 |
| dir.target | The folder for the database to be written. This could be direct to the Rockbox (.rockbox) folder or an intermediate folder. | dir.target=/home/user/temp/rockbox |
| 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.