TAGAGOTCHI 2000 v1.1

Programmed by Joonas Hirvonen with Delphi 5

Tagagotchi is freeware

Mail feedback, bug reports, suggestions to toytools@hotmail.com
Check out http://welcome.to/toytools for updates & other tools


===[ CONTENTS ]=================================================================

 1. Introduction
 2. Naming files
 3. Naming directories
 4. Tagging the files
 5. Buttons explained
 6. Menus explained
 7. Hints


===[ 1. INTRODUCTION ]==========================================================

Tagagotchi is a tool for setting ID3 tags to mp3-files. ID3 tag is a
short (128 bytes) field where you can save some info of the song
(title, artist, album, year, genre, comment and track number).

Most mp3-players can edit the tag fields but when you encode hundreds of
songs and then set the tags to them by typing... aaargh...

Or, when you get mp3s from your friends or from the internet, the filenames
or tags aren't always the way you want them to be...

...this is were Tagagotchi proudly steps on the catwalk.


===[ 2. NAMING FILES ]==========================================================

To function, the files have to be named like one of the following alternatives:

 1.  xx. Song.mp3
     xx - Song.mp3

     Where "xx" is the number of the song. Notice the space-characters.
     This naming method is probably the best for a whole album of one single
     artist.

     Examples: 02. Ordinary Story.mp3
               02 - Ordinary Story.mp3

 2.  xx. Artist - Song.mp3
     xx - Artist - Song.mp3

     Same as above plus the artist. This naming method suits e.g. for
     compilation and tribute albums with many different artists when you still
     want to maintain the song order. When this naming method is used, you
     don't have to fill the artist field, it's fetched from the filename.

     Examples: 01. Gloomy Grim - Say Just Words.mp3
               02 - Gloomy Grim - Say Just Words.mp3

 3.  Artist - Song.mp3

     Same as above without the song number. Good naming method for various
     single songs. When this naming method is used, you don't have to fill the
     artist field, it's fetched from the filename.

     Examples: Children Of Bodom - Deadnight Warrior.mp3

 4.  Song.mp3

     Plain song name as filename. Usable if you have various songs from an
     artist in one directory, for example.

     Examples: In The Shadow Of The Horns.mp3

FILENAME FORMAT also affects TRIM FILENAMES and RENAME FROM TAGS functions.


===[ 3. NAMING THE DIRECTORIES ]================================================

Check out the DIRNAME FORMAT dropdown-list. If you name your mp3-directories
like one of those alternatives, Tagagotchi can fetch the artist / album from
the dirname.

 1.  Artist - Album

     Example: C:\MP3\Darkthrone - A Blaze In The Northern Sky\

 2.  Artist \ Album

     Example: C:\MP3\Darkthrone\A Blaze In The Northern Sky\

 3.  Artist \ Album \ Disc

     Example: C:\MP3\Metallica\S&M\Disc 1\

 4.  Artist

     Example: C:\MP3\Emperor\

 5.  Album

     Example: C:\MP3\Wrath Of The Tyrant\


===[ 4. TAGGING THE FILES ]=====================================================

Choose the drive and folder where the files exist, then select the files from
the filelistbox. Choose a FILENAME FORMAT that matches your filenames. Fill in
the appropriate tag fields. If you use filename naming method 2 or 3, no artist
can't be entered.

Press TAG button and you're done. You can now double-click any of the files in
the filelistbox to check the result.

Tagagotchi warns if there's a conflict between a filename and the selected
filename format.

If there are files that result over 30 character long song / artist names and
you have ASK TITLE IF OVER 30 CHARS option enabled, a window will pop out and
you can edit the song or artist name / continue it to the comment field.


===[ 5. BUTTONS EXPLAINED ]=====================================================

REFRESH
Refreshes the directory- and fileboxes. Also "refetches" artist / album name.

RENAME DIR
Renames a selected directory.

RENAME FILES
Simply lets you rename selected files.

TRIM FILENAMES
Trims selected filenames. Check out trimming options from the settings-menu.
You can either capitalize or sentence the filename. This function also converts
"badly" numbered files to correct format (either xx. title.mp3 or xx - title.mp3).
Also, choose the FILENAME FORMAT you'd like the files to trimmed to.

REPLACE TEXT
With this you can do search & replace operations for the selected filenames.
The search is case-sensitive. The replace field can be left blank if you just
want delete pieces of text.

EDIT TAGS
Pop-outs a window for editing one or multiple files. Same as double-clicking
files.

PLAY FILE
Plays a selected file using the default player for mp3-files.

COPY TAG
Simpy copies the tag data of the selected file to the tag fields on screen.

RENAME FROM TAGS
Renames files based on their track # / artist / title tag fields.
Again, choose the format you want with FILENAME FORMAT.


===[ 6. MENUS EXPLAINED ]=======================================================

EXPLORE DIRECTORY
Opens the current directory with Windows explorer.

CLEAR ID3 FIELDS
Clears the text fields.

SET ID3 FIELDS
From this submenu you can select which fields you want to set.

ASK FILENAME IF OVER 64 CHARS
When you rename files, trim filenames or rename from tags and the filename exceeds
64 characters, you will be asked for new one. Useful if you burn CDs with the
Joliet-filesystem.

SHOW TAG IN STATUSBAR
If you want tag data of a selected file to be shown in statusbar, check this.

SAVE SETTINGS
Saves the state of filename format and dirname format plus the settings-menu
switches.


===[ 7. HINTS ]=================================================================

DEFAULT DIRECTORY
You can set Tagagotchi's default directory by making a shortcut to it and
editing it's properties (work folder).

