https://github.com/jangler/taffy

Command-line audio tagging tool
https://github.com/jangler/taffy

Last synced: 26 days ago
JSON representation

Command-line audio tagging tool

• Host: GitHub
• URL: https://github.com/jangler/taffy
• Owner: jangler
• License: mit
• Created: 2015-04-10T01:06:05.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2024-12-18T14:26:53.000Z (4 months ago)
• Last Synced: 2025-03-30T12:10:12.773Z (about 1 month ago)
• Language: Ruby
• Homepage:
• Size: 20.5 KB
• Stars: 36
• Watchers: 2
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Taffy

=====

Taffy is a command-line tool for reading and writing audio metadata, as

supported by [TagLib](http://taglib.github.io/). That means it can edit

tags for MP3, Ogg Vorbis, FLAC, WAV, and MP4 files, along with several

other file formats.

Installation

------------

If installing via `gem`, you must have already installed your

distribution's TagLib package, usually called `taglib`, `taglib-devel`,

or `libtag1-dev`. Then run:

	gem install taffy

If you use Arch Linux or a derivative, you may also install via the [AUR

package](https://aur.archlinux.org/packages/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.