-> RGMP3 - a ID3 to FILE_ID.DIZ Converter <-
                        - generik productions '04 -

                        °±²Û What Does it do? Û²±°

Well, manually uploading Mp3s can take a while (Especially if you have
lots of em to do). And it's damn annoying especially if the MP3 already
has an internal description that you can't touch. What RGMP3 does is
extract that description and makes a FILE_ID.DIZ file that Renegade can
import. This way, as long as the MP3s contain descriptions, then you're clear
sailing. Sure beats the hell out of having to enter all those titles and
artists individually.

Unfortunately, due to the constant change of the ID3 2.0 spec (and the five
year gap in which this util has been updated), RGMP3 still only supports
ID3 1.1 tags (which most players still use anyway).

On the plus side, the FILE_ID.DIZ is now 100% configurable simply by editing
the TEMPLATE.DIZ file. You'll need to provide the full location to this file
on the commandline when running the utility. More on the format later.

Command Line:

     RGMP3 <template> <filename>

This will create a file_id.diz from the <filename> in the current directory
using <template> to format the diz file.

                         °±²Û Setting it up Û²±°

Just a couple steps to setting Renegade up to work with it:

Step 1 - Move the EXE file to the directory that you have setup in RG as the
         "Archivers directory"

Step 2 - Make sure RG is setup to use FILE_ID.DIZ descriptions if it finds
         them. (in the File System Configuration menu)

Step 3 - Configure Renegade to consider an MP3 file to be an archive. Go into
         the Archive Configuration (From the System Configuration menu) and
         add a new Archive type.

Step 4 - Modify the new archive type to look exactly like the one below:

Archive x of x

1. Active                 : Yes
2. Extension name         : MP3
3. Interior list method   : *None*
4. Compression cmdline    : *None*
5. Decompression cmdline  : rgmp3 <template> %F
6. File testing cmdline   : rgmp3 <template> %F
7. Add comment cmdline    : *None*
8. Errorlevel for success : -1 (ignores)
Q. Quit

Edit menu: (1-8,[,],Q):

Replace <template> with the full path to where your TEMPLATE.DIZ is located
(eg. c:\rg\template.diz).

Thats it! Now whenever a MP3 file is uploaded (locally or remotely) it'll
create a FILE_ID.DIZ if theres a ID3 description in the MP3.

*NOTE* RGMP3 2.0 should work with practically any BBS program that uses
       archivers in this way.

                            °±²Û Template Û²±°

This new version supports 100% configurable template files, using tags. Here
be the relevant ones you can use:

     %song%    - song title
     %artist%  - err..artist.
     %album%   - album name
     %year%    - album year
     %comment% - user comment
     %track%   - album track number

I've left out genres mainly because there is no longer a set standard. Most
music players (including Winamp & XMMS) have changed the list around too much
for them to be of any use.

                              °±²Û Misc Û²±°

If you have any probs or questions (or want to contribute instructions to
getting it to work with other BBS programs) drop me a line:

BBS: The Resurrection ú telnet://resbbs.ath.cx ú Email: resbbs@generik.ca

Eventually you'll also be able to check out the website (www.generik.ca) for
updates and other BBS stuff.

                                         Enjoy!  doc, generik productions '04

*EoF*