*******************************************************************************
****                                                                       ****
**                      Tric's Renatager 0.8.2 Build 135                     **
*                           done by tric@renatager.de                         *
*                            http://www.renatager.de                          *
**                            Copyright  1998-2000                          **
****                                                                       ****
*******************************************************************************

_____________________________________________
INDEX

a) Renatager?? Never heard about!
b) Installation
c) Translatins and Addons
d) Tric's expressions
e) Why freedb? ...and the cddb support
f) Special Versions?
g) Disclamer


_____________________________________________
a) RENATAGER?? NEVER HEARD 'BOUT!

Some people asking me: 'What the hell is Renatager?'. Sorry I do _not_ give a
list of features here, because I would never get finished ;). So let me
tell you why there exists such a nice thing on earth:

Some years ago in late 1998 there was a long night, me and namhan tried to 
encode some waves. But there were some stupid chars in the filename, so namhan
decided to code a small VB app, which just removes them. Later i thought, 'VB?
that suxxx' ;), so i decided to code exactly the same app in Delphi (uhhh, i 
know it's not that much better, but....). Some hours later, there were some new
cool functions and i thought about ID3 support for multiple files.
In early April 1999 i decided to publish this new cool tool and got great 
response, so i went on... So here you see the latest verion, which does not
have much to do with 'Tric's Meister Renamer' developed 1998 , but in my
opinion its still a (small!?) cool program...

But anyway, for all of you who cannot life without a list of features, here
are some...

- Regular Expressions
- Full mp3, PCM wave support (and you can rename any other file!)
- Full preview 
- All file actions are logged for full undo (Not the tag things, sorry)
- Name your mp3/wave Album from cddb/freedb (NO you don't need a cd-rom!)
- Tag multible files from their filename using ID3v1.1 and! Lyrics3v2 Tags
  (ID3v2 is upcoming)
- rename files by some nice other rules ;)
- rename files based on their tags  
- and all this in an nice explorer interface or standard file-listview...
- ... and some other cool stuff....


_____________________________________________
b) INSTALLATION

Just unzip all and start mp3renatager.exe 

List of Files:

English.rlp          <-- English translation
German.rlp           <-- German Original "Translation"
history.txt          <-- Version History
mp3renatager.exe     <-- This is the Program File
Polish.rlp           <-- Polish translation (thx to TASIORD)
Readme.txt           <-- do i have to say anything??
uninstall.exe        <-- unistall script, removes registry keys and files

The Renatager saves it's Preferences in an ini file called mp3renatager.ini 
located in its directory. The only registry keys used are the context menu
entrys and the uninstall info.
Also a mp3renatager.log is created wich the history of all file renaming 
operations. In mp3renatager_cddb.log the are the debug info of the cddb 
gateway.

Sorry there is no help file avaiable at the moment. Feel free to make one ;).


_____________________________________________
c) TRANSLATIONS AND ADDONS

Renatager should recognize if a non German OS is running, if not use the 
commandline parameter "-L <file.rlp>" to enforce a language. 
e.g. "mp3renatager.exe -L english.rlp".

Uhh, i know my English is not very good, so please correct the English Language 
File (its a normal txt file). You are also welcome to create some new 
Translation in Spanish or your prefered language!


_____________________________________________
d) TRIC'S EXPRESSIONS

Please insert the form of the original name in "form". The first character of 
the Variables have to be "%" and they should be only one character long 
("%1" or "%A"). All other characters will be used to divide. To delete some 
characters, just do not enter their variable into "to".
some Examples:
filename             : 01 my artist - his song.mp3
from                 : %a %b - %c
to                   : %a %c -- %b
new filename will be : 01 his song -- my artist.mp3

filename             : my_artist_-_01_his_song.mp3
from                 : %a_-_%b_%c
to                   : %b %a - %c
new filename will be : 01 my_artist - his_song.mp3

Just enter the Rename Actions from the Popupmenu and fill if needed the 
Brackets. Sorry thats something like a expert function, so no more help 
avaiable ;)

_____________________________________________
e) SPECIAL VERSIONS

There are special OEM Version available. Please contact me for further 
Informations. In such a version you can ask for special feautures, etc. 
But in order to create such a version, i normaly ask for some donation.


_____________________________________________
f) WHY FREEDB? ... AND THE CDDB SUPPORT

There are three versions of cddb/freedb support. First of all you can
create the cddb ID from the mp3/wav files. They have to be in the right 
order and the exact length. Secondly you can the renatager ask to 
detect the cddb ID by the CD inserted in one of the CD-Rom. The third
choice you have is to enter the cddb Genre and ID directly into the
editboxes. You can get it from www.freedb.org.

Well, you're asking why i moved cddb to only second choice? Here is my
answer:
First of all you may choose you own sequence! But the reason is: 
cddb got some cool new features when they changed to version 2. But only 
for you! the users. The developer now have to pay for providing this service
in their programs. Sure, only if they've distributed a number of versions,
BUT, whats with freeware? I heard about authors who didn't get any cash out
of ther projects. Hmm, they also have to pay (got long nice mails with cddb
support ;)). Because it seems Tric wasn't the only one not loving this 
situation, freedb.org were created. Its uses the same old cddb1 server 
software but it is build completly under the GPL. You're able to download
not only the complete database, also the server software. 
for further information take a look at http://www.freedb.org !


_____________________________________________
g) DISCLAMER

I do not take any responsibility for any Damage caused by this program. 
It is just a project i coded for myself which i published. If you found an 
error feel free to send me a description, but do not bother me if your
mail is not constructional ;).
Feel free to copy your version, but it's not allowed to sell it in any way!


_______________________________________________________________________________
Tric's Renatager 0.8.2 Build 135
tric@renatager.de
http://www.renatager.de

ooohh, wow, i finally got a Readme.txt? So Renatager seems to be very 31337 ;)