Taffy

Taffy is a command-line tool for reading and writing audio metadata, as supported by TagLib. That means it can edit tags for MP3, Ogg Vorbis, FLAC, WAV, and MP4 files, along with several other file formats.

Installation

On Debian, required dependencies are named ruby-dev, ruby-rubygems, and libtag-dev. In the source directory, run:

gem build taffy.gemspec
gem install taffy-*.gem

You can also install directly from RubyGems, although it will not be the latest version:

gem install taffy

Usage

Usage: taffy [options] file ...

Tag options:
    -l, --album ALBUM                Set album tag
    -r, --artist ARTIST              Set artist tag
    -c, --comment COMMENT            Set comment tag
    -g, --genre GENRE                Set genre tag
    -t, --title TITLE                Set title tag
    -n, --track TRACK                Set track tag
    -y, --year YEAR                  Set year tag
        --no-album                   Clear album tag
        --no-artist                  Clear artist tag
        --no-comment                 Clear comment tag
        --no-genre                   Clear genre tag
        --no-title                   Clear title tag
        --no-track                   Clear track tag
        --no-year                    Clear year tag
        --clear                      Clear all tags

Filename options:
        --extract SPEC               Extract tags from filename
        --rename SPEC                Rename file based on tags
        --rename-fs SPEC             Like --rename; see below

If no options are given, file tags are printed instead.

In a filename spec, a sequence such as %R or %r stands for
the corresponding tag, in this case the artist name. In a
filename, %R leaves letter case intact, while %r downcases
the tag. A sequence such as %_t maps special characters in
the tag to the given substitute, in this case an underscore.
--rename remaps all characters that need to be escaped in
the shell, while --rename-fs remaps only characters that
are invalid in filenames.

Other options:
    -h, --help                       Show this message and exit
        --version                    Show version and exit

Examples

Print tags from an audio file:

taffy song.mp3

Tag a series of files with an artist, album, and year:

taffy -r Deerhoof -l "The Man, The King, The Girl" -y 1997 *.mp3

Tag an audio file, then rename it to "14 - Queen of the Mole People.mp3":

taffy -n 14 -t "Queen of the Mole People" --rename-fs "%n - %T" song.mp3

Etymology

Taffy tags audio files for you.