Create index of MPEG or Ogg-Vorbis audio files

Release: 0.11 beta

Features

• This REXX utility creates an fixed format machine and human readable ASCII index file of a volume or folder with MPEG or Ogg-Vorbis audio files.
• Meta information (e.g. artist) is extracted and written to the index.
• The files are checked for consistency roughly.
• The previous index file is updated if possible. So only the new and modified files have to be checked.
• A master index file, named Index, is maintained containing volume information.

Download

ZIP file with REXX script and this guide:

Currently this script is dedicated to OS/2. There are some features around the codepage translations which relate to OS/2 specific REXX extension and a custom OS/2 DLL module.

Installation

• Get RxMMUtl and place the DLLs somewhere in your LIBPATH.
• Place the REXX file somewhere on your hard drive.
• For the MPEG file support you must have frameanalyzer in your search PATH.
• For the Ogg Vorbis file support you must have vorbisinfo in your search PATH. This is part of the Ogg Vorbis package since version 1.0.

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 audio files with madonna in the meta info. The Output has the form
   volume:
   index file line
because 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) bit rate in 1000 bits per second
F	1	77	format tag: ' = CBR MP1, ² = CBR MP2, ³ = 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 corresponding 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 (Aug. 25th 2002)

• first public release

• Fix: sometimes files are scanned again even if they are unmodified.

ToDo

• Handle ID3v2 tags

Contact

Suggestions, help, complaints (but not too much:-):

Original homepage: http://www.maazl.de/project/mp3/getaudiodir.html