<h1>tagomatic</h1>
<p>
Simple command-line mp3 tagger based on mp3info gem. Supports
folder-specific configuration files.
</p>
<p>
Another mp3 tagger the world does not need.
</p>
<p>
But I needed it. I have a large collection of old mp3 files. From times
when tagging was mostly based on the file and folder names. When v2 tags
where nowhere close..
</p>
<h2>Overview</h2>
<p>
Modes of operation:
</p>
<ul>
<li>The tagger will try to guess the tags from the full file path by applying a
set of known formats.
</li>
<li>The tagger will apply specific tags given on the command-line.
</li>
<li>The tagger will match specific formats given on the command-line.
</li>
<li>Arbitrary combination of the before-mentioned modes.
</li>
</ul>
<p>
The scanner supports recursive folder handling. Of course.
</p>
<p>
Right now v2 tags are the focus.
</p>
<p>
It is probably best to call this alpha ware.
</p>
<h2>Usage</h2>
<p>
For my genre/artist/album/track.mp3 collection I use this invocation
pattern:
</p>
<p>
tagomatic —underscores —guess —recurse —showtags
—errorstops —cleantags /media/music/
</p>
<p>
Then I add folder-specific .tagomatic or .format= files whenever an error
occurs.
</p>
<h2>The .tagomatic file</h2>
<p>
You can put the (long version) of the command line options into
folder-specific .tagomatic files. These options are then valid only for
this folder and sub-folders.
</p>
<p>
This is useful - for example - if you want to switch guessing off for
sub-folders.
</p>
<h2>The .format= files</h2>
<p>
You can add files named .format= to sub-folders. They will be picked up by
tagomatic and added as custom formats just as if you would have passed them
on the command line using the —format option.
</p>
<p>
Because the slash is not allowed in file names you have to replace it with
a vertical dash like in this example:
</p>
<p>
.format=%g|%a|%b|%n - %t.mp3
</p>
<p>
These formats are valid only for this folder and sub-folders.
</p>
<h2>Copyright</h2>
<p>
Copyright © 2009 Daniel Lukic. See LICENSE for details.
</p>