audiotag 0.0.1

A simple CLI audio tagger.

audiotag

Audiotag is a command line audio tagger written in python3. It uses TagLib to write the metadata. It features a very simple to use interactive mode which lets you tag a single album as fast as possible.

Installation

You can install audiotag directly from PyPI

pip install audiotag

Usage

Audiotag offers different subcommands:

Usage:
  audiotag interactive <FILE>...
  audiotag print <FILE>...
  audiotag clean <FILE>...
  audiotag rename [-p PATTERN] <FILE>...

The print subcommand prints all tags. Multiple values per tag will be printed as a list.

$ audiotag print *.flac
Filename: /path/to/files/1 - At Giza.flac
ALBUM: ['Conference of the Birds']
ARTIST: ['Om']
DATE: ['2006']
DISCNUMBER: ['1']
DISCTOTAL: ['1']
ENCODER: ['Lavf58.12.100']
GENRE: ['Doom Metal']
TITLE: ['At Giza']
TRACKNUMBER: ['1']
TRACKTOTAL: ['2']

Filename: /path/to/files/2 - Flight of the Eagle.flac
ALBUM: ['Conference of the Birds']
ARTIST: ['Om']
DATE: ['2006']
DISCNUMBER: ['1']
DISCTOTAL: ['1']
ENCODER: ['Lavf58.12.100']
GENRE: ['Doom Metal']
TITLE: ['Flight of the Eagle']
TRACKNUMBER: ['2']
TRACKTOTAL: ['2']

The interactive subcommand interprets all given files as a single album and asks for all the necessary information. If the Number of discs value is anything greater than 1, audiotag will ask you which disk you are currently tagging. Otherwise the DISCNUMBER tag will also be set to 1. Number of songs is used to determine the number of leading zeroes when you use the rename subcommand.

$ audiotag interactive *.flac
Artist: Om
Albumtitle: Conference of the Birds
Genre: Doom Metal
Year: 2006
Number of songs: 2
Number of discs: 1
/path/to/files/1 - At Giza.flac
Title: At Giza
/path/to/files/2 - Flight of the Eagle.flac
Title: Flight of the Eagle

The rename subcommand lets you rename files based on the audio tags. You have to provide a pattern for renaming. The pattern may contain a combination of these placeholders:

• {L}: Album
• {R}: Artist
• {G}: Genre
• {T}: Title
• {N}: Track
• {D}: Discnumber
• {Y}: Year

You do not have to add the extension to the pattern. Audiotag adds the extension to the output file name for you.

$ ls
01-at_giza.flac  02-flight_of_the_eagle.flac

$ audiotag rename -p "{N} - {T}" *.flac

$ ls
'1 - At Giza.flac'  '2 - Flight of the Eagle.flac'

The clean subcommand removes all tags from the file except the ENCODER tag.

Dependencies

The following dependencies are needed to run audiotag:

• docopt: For parsing command line arguments
• pytaglib: Python wrapper for accessing TagLib