ID3Browse - ID3 Playlist Generator v1.0
Copyright 2002 - Shane Brinkman-Davis
This software is FREEWARE. You can use it and copy it as much as you
want. I warranty NOTHING. Of something goes wrong because you used this
software, its not my fault. USE AT YOUR OWN RISK.
That said, I don't think this soft will cause any deleterious effects.
This software requires Windows 95 or better. I have tested it on Win98
and Win2000, and it should work on 95, ME, XP, NT, etc...
The program needs about 25megs to run. That means your computer needs at
least 64 megs to be able to run this program reasonably.
The goal of this software is to generate playlists organized in
directories from any information found in ID3 tags. The core use of
this is to emulate ID3 based browsing for File-System based MP3 players
such as Archos' Jukebox line.
After using coding this up, I have realized that this program allows you
to have much more control over ID3-based browsing that you get on MP3
players with hard-coded ID3 based browsing.
First Time Use
To generate some standard ID3-based browsing directories and playlists,
follow this simple quick-start guide below. This sill make an ID3
directory on the root of your MP3 player's hard drive with many
directories and playlists inside it. It will not delete, move, copy
or modify your MP3s.
1) Copy all your MP3s to your player
2) Copy ID3Browse.exe and the .bat files to your MP3 player
3) Double click on the "Generate Standard ID3 Based Browsing.bat"
file ON YOUR MP3 player
4) Wait a few minutes while the ID3 directories and playlists
5) When it is done you will see the message: "ID3Browse - done!"
and some statistics.
6) Press a key to close the window - that's it!
The batch file in step 3 above creates 4 standard ways to browse your
Disconnect your MP3 player and browse the ID3 directory - you should
find it very much like browsing your whole collection my ID3 tags!
Whenever you add MP3s, just re-run this program. If you delete MP3s,
delete the ID3 directory and re-run this program.
Want more? With ID3Browse you can setup just about any way to browse
your MP3s based on ID3 tags. Read on if you want to learn how.
Basic Command Line Options
ID3Browse is a command-line utility. If you are not familiar with the
DOS command line, you may prefer to make copies of the example .BAT file
and editing it to change the options.
ID3Browse command line options look like this:
ID3Browse ScanDir FormatString(s)
Basically, this program scans ScanDir and all its subdirs for all MP3s.
Then, it creates directory trees with M3U playlists from the MP3's ID3
tags based on the format strings.
When you run ID3Browse, you must provide a ScanDir and at least one
The power of this program comes from its FormatStrings
A format string describes how you want to browse your MP3s. Format
strings consist of a directory name and a sequence of keywords joined by
A keyword refers to an ID3 field - or data calculated from an ID3 field.
Valid keywords are:
ARTIST, ALBUM, SONG, GENRE, YEAR, DECADE, and COMMENT
Any 4 character ID3v2 text tag ID: T???
(see below for some known text tag ids)
Some example Format Strings:
ID3Browse takes all your mp3s in ScanDir and, for each format string,
sorts them by the keywords you specified. It sorts by the first keyword
first and then subsorts on the second, etc... For each keyword up to the
last one, it creates directories and sub directories. For the last
keyword, it creates a playlist file (.m3u) for each unique value.
For example, the keyword sequence "Artist+Album" directs ID3Browse to
sort all MP3s by Artist and subsort by Album. It then creates a
directory for each Artist and, in each artist's directory, it creates a
playlist for each album.
The format string "\ID3\JustArtist=Artist" makes a playlist of all songs
for each artist and puts it in the directory \ID3\JustArtist.
There is one more thing you can do with your keywords. You can limit the
number of characters used from the keyword. Any keyword can have a colon
(:) added immediately after it and then a number that specifies how many
characters to use. This can be very handy if you have too many, say,
artists to list in one directory.
Example Format String:
This string tells ID3Browse to sort all MP3s by the first letter of each
artist. Then, inside those directories, sort by the fill artist name.
Inside each artist's directory, it makes a playlist for each of that
artist's albums. Here is how \ID3\Artist might look after you run this
\ID3\Artist\A\Art of Noise\In no sense? Nonsense.m3u
\ID3\Artist\A\Art of Noise\The Seduction of Claude Debussy.m3u
So, to be very formal, the format of a FormatString is:
RootDirectory can be any valid path
Keyword is any valid keyword - see above
':' and '+' appear literally
[...] parts are optional - when used don't type the ''s,
only what is inside them.
[...]* parts can be repeated 0 or more times
'Num's are positive decimal integers
Some ID3v2 Text TagIDs
TALB Album/Movie/Show title
TBPM BPM (beats per minute)
TCON Content type
TCOP Copyright message
TDLY Playlist delay
TENC Encoded by
TEXT Lyricist/Text writer
TFLT File type
TIT1 Content group description
TIT2 Title/songname/content description
TIT3 Subtitle/Description refinement
TKEY Initial key
TMED Media type
TOAL Original album/movie/show title
TOFN Original filename
TOLY Original lyricist(s)/text writer(s)
TOPE Original artist(s)/performer(s)
TORY Original release year
TOWN File owner/licensee
TPE1 Lead performer(s)/Soloist(s)
TPE3 Conductor/performer refinement
TPE4 Interpreted, remixed, or otherwise modified by
TPOS Part of a set
TRCK Track number/Position in set
TRDA Recording dates
TRSN Internet radio station name
TRSO Internet radio station owner
TSRC ISRC (international standard recording code)
TSSE Software/Hardware and settings used for encoding
Currently, ID3Browse supports ID3 v1, v1.1, v2.3 and v2.4 tags. That
means ID3 v2.2 tags are not supported. If there is demand, I'll put them