Wiki > Main > UseDisplayName (compare)
Difference: UseDisplayName (r6 vs. r5)
Using display names allows you to browse files using the id3 tags embedded into most mp3 files. An id3 tag contains extended information about an mp3 file. You probably already use id3 tags to store information about the title, artist, track number, genre, album, and other information about the music contained in the mp3.
A quick note: this is NOT an id3 database like TagCache?DataBase. You probably wouldn't want to use this to quickly switch between sorting by different criteria. The purpose of this feature is to allow you to browse and play back a folder full of mp3s in a different order than alphabetical file name.
Right now this feature is not part of the rockbox distribution. If you want it, you will have to download the source code (either CVS or a recent daily build) and apply a patch. Since you will be working with a daily or bleeding-edge build, please ensure that you back up any important files on your Archos unit, and that you are familiar with recovery features should you experience problems. Having said that, I can say that this feature has been tested on several different models without any issues. If you experience a problem with the feature, report it to me, or report it at the sourceforge listing for this patch.
If you'd like a prebuilt object file for your unit, there are some builds on the SourceForge patch tracker for this patch. You will need to have a recent daily build installed already (so that you have the latest version of the plugins and such). Again, be warned: using a daily build is riskier than using a release build. There are two files: one is the plugin (build_id3_names.rock) that belongs in
Once you have applied the patch and built the code, (or installed the prebuilt files) you will need to enable the feature. In the main menu, under "General Settings" and "File View" select "Use id3 Tags in Browser" and set this option to "Yes". You will need to reboot the unit after this, since certain variables that can only be initialized at startup have to be created.
Display formatting is controlled by:
Style files (.display and .display_global) follow a simple format:
For instance, say you have a directory containing a file called "Track 01.mp3" that is "My Song" by "My Artist" and is track "1"
The formatting string
The formatting string
If there is no useful id3 information in the file, then the file name is used.
(New for patch version 5) The feature will select the id3 v1 or v2 data based on your preferences settings.
This feature creates a directory called
(New for patch version 5) There is now an option in the ON+PLAY menu for directories to clear the cache for the selected directory.
Browsing folders with id3 names is slower than just using file names, since in order to read id3 information, we need to open each file. Caching reduces this problem somewhat.
For a directory of 44 files, on a Recorder V2,
In addition, this uses slightly more disk access and a small amount of RAM. Of course, with the .display and .display_global files, you can control which directories you want to view file names for, and which directories you need to have sorted differently.
This feature is still a work in progress. In its current form, it works, and works well. However, there is always room for improvement.
-- JonathanDeonarine - 07 Aug 2004
r6 - 25 Nov 2006 - 11:50:04 - DanielStenbergRevision r6 - 25 Nov 2006 - 11:50 - DanielStenberg
Revision r5 - 28 Mar 2006 - 00:09 - BernardKethlayne
Copyright © by the contributing authors.