Create index of MPEG or Ogg-Vorbis audio files

Features

Download

Installation

Usage

getaudiodir source [destination]

source

Drive or folder to be indexed.

destination

Destination folder for index files. Default: current working directory.

Examples

getaudiodir g:

Create index of all files on drive G and write it to the current directory. The name of the index file is taken from the volume label of drive G.

getaudiodir d:\audiofiles d:\audioindex

Create index of all files in d:\audiofiles and subfolders and write it to d:\audioindex\audiofiles.

grep -i madonna d:\audioindex\*

Find all indexed audiofiles with madonna in the metainfo. The Output has the form
   volume:
   index file line
beacause the index file names are the volume labels.

Format of index files

Each source file has a separate line in the index file. The lines are in the filesystem's order. Each line has the following format:
Column:
00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001111111111111111111111111111111111111111111111111111111
00000000011111111112222222222333333333344444444445555555555666666666677777777778888888888999999999900000000001111111111222222222233333333334444444444555555555566666
12345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa tttttttttttttttttttttttttttttt yyyy mm:ss rrrF CC AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA cccccccccccccccccccccccccccccc TT KKKKK WWWWWWWW fff...

Wrapped at 80 columns it looks like:
Column:
00000000011111111112222222222333333333344444444445555555555666666666677777777778
12345678901234567890123456789012345678901234567890123456789012345678901234567890
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa tttttttttttttttttttttttttttttt yyyy mm:ss rrrF CC
 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA cccccccccccccccccccccccccccccc TT KKKKK WWWWWWWW
 fff...

item	length	columns	description
aaa...	30	1-30	artist name
ttt...	30	32-61	song title
yyyy	4	63-66	release year
mm:ss	5	68-72	playback length in minutes:seconds
rrr	3	74-76	(average) bitrate in 1000 bits per second
F	1	77	format tag: space = CBR MP3, v = VBR MP3, o = Ogg-Vorbis
CC	2	79-80	channel mode: M = mono, S = stereo, JS = joint stereo
AAA...	30	82-111	album name
ccc...	30	113-142	comment
TT	2	144-145	track number
KKKKK	5	147-151	file size in kilobytes (1024 bytes)
WWWWWWWW	8	153-160	unix time stamp as hex value
fff...	as needed	162...	file name including relative path

Format of the master index file

• The master index file has the name Index and is stored in the same folder as the other index files.
• It is updated once one of the index files has changed.
• The first line is the column header line.
• The header is followed by one line per other index file.
• The Lines are ordered by the names of the correponding index files (i.e. volume labels or folder names).

Each line has the following fixed length format:
Column:
0000000001111111111222222222233333333334444444444555555555566666666667
1234567890123456789012345678901234567890123456789012345678901234567890
nnnnnnnnnnnnnnnnnnnnnnnnnnnnnn NNNNNN KKKKKKKKKK SSSSSSSSSS FFFFFFFFFF

item	length	columns	description
nnn...	30	1-30	volume label or folder name
NNNNNN	6	32-37	number of files
KKKKKKKKKK	10	93-48	total size of all files in kilobytes (1024 bytes)
SSSSSSSSSS	10	50-59	total size of the volume in kilobytes (1024 bytes)
FFFFFFFFFF	10	61-70	free space on the volume in kilobytes (1024 bytes)

History

Version 0.1 (25. Aug. 2002)

• first public release

ToDo

• Handle ID3v2 tags

Contact