<?xml version="1.0" encoding="utf-8"?>
<!--
Copyright (C) 2007-2015  Brian Langenberger
This work is licensed under the
Creative Commons Attribution-Share Alike 3.0 United States License.
To view a copy of this license, visit
http://creativecommons.org/licenses/by-sa/3.0/us/ or send a letter to
Creative Commons,
171 Second Street, Suite 300,
San Francisco, California, 94105, USA.
-->
<manpage>
  <utility>tracktag</utility>
  <author>Brian Langenberger</author>
  <section>1</section>
  <name>update audio file metadata</name>
  <title>Audio File Tagger</title>
  <synopsis>[OPTIONS] &lt;track 1&gt; [track 2] ...</synopsis>
  <description>
    tracktag takes new metadata values and a list of audio files
    and updates those files with the new values.
  </description>
  <options>
    <option short="h" long="help">show a list of options and exit</option>
    <option short="I" long="interactive">
      Once any other command-line arguments are processed,
      edit the given tracks in interactive mode.
    </option>
    <option short="r" long="replace">
      this options erases all existing metadata and replaces it
      with any specified values
    </option>
    <option long="replay-gain">
      add ReplayGain metadata to tracks
    </option>
    <option long="remove-replay-gain">
      remove ReplayGain metadata from tracks
    </option>
    <option short="j" long="joint" arg="processes">
      The maximum number of albums to calculate ReplayGain for at one time.
    </option>
    <option short="V" long="verbose" arg="verbosity">
      The level of output to display.
      Choose between 'normal', 'quiet' and 'debug'.
    </option>
  </options>
  <options category="text">
    <option long="name" arg="name">
      the name of the track
    </option>
    <option long="artist" arg="name">
      the track's artist
    </option>
    <option long="performer" arg="name">
      the track's performer
    </option>
    <option long="composer" arg="name">
      the track's composer
    </option>
    <option long="conductor" arg="name">
      the track's conductor
    </option>
    <option long="album" arg="name">
      the track's album name
    </option>
    <option long="catalog" arg="number">
      the album's catalog number, typically indicated on its case
    </option>
    <option long="number" arg="number">
      the track's number on the disc
    </option>
    <option long="track-total" arg="number">
      the total number of tracks on the disc
    </option>
    <option long="album-number" arg="number">
      the album's number, if it is one in a series of albums;
      for example, a 3 CD set might have an album number of 1, 2 or 3
    </option>
    <option long="album-total" arg="number">
      the total number of albums in the set
    </option>
    <option long="compilation" arg="yes/no">
      whether the track is part of a compilation
    </option>
    <option long="ISRC" arg="ISRC">
      the track's ISRC
    </option>
    <option long="publisher" arg="name">
      the album's publisher
    </option>
    <option long="media-type" arg="media">
      the album's media type, such as "CD", "vinyl", etc.
    </option>
    <option long="year" arg="year">
      the album's release year
    </option>
    <option long="date" arg="date">
      the track's original recording date
    </option>
    <option long="copyright" arg="copyright">
      the album's copyright information
    </option>
    <option long="comment" arg="text">
      comment text
    </option>
    <option long="comment-file" arg="filename">
      a file containing comment text, for particularly long comments
    </option>
  </options>
  <options category="removal">
    <option long="remove-name"/>
    <option long="remove-artist"/>
    <option long="remove-performer"/>
    <option long="remove-composer"/>
    <option long="remove-conductor"/>
    <option long="remove-album"/>
    <option long="remove-catalog"/>
    <option long="remove-number"/>
    <option long="remove-track-total"/>
    <option long="remove-album-number"/>
    <option long="remove-album-total"/>
    <option long="remove-compilation"/>
    <option long="remove-ISRC"/>
    <option long="remove-publisher"/>
    <option long="remove-media-type"/>
    <option long="remove-year"/>
    <option long="remove-date"/>
    <option long="remove-copyright"/>
    <option long="remove-comment"/>
  </options>
  <options category="CD lookup">
    <option short="M" long="metadata-lookup">
      perform metadata lookup for tracks as if they were a single CD
    </option>
    <option long="musicbrainz-server" arg="hostname">
      the MusicBrainz server name to query for metadata
    </option>
    <option long="musicbrainz-port" arg="port">
      the MusicBrainz port to query for metadata
    </option>
    <option long="no-musicbrainz">
      don't query MusicBrainz for metadata
    </option>
    <option long="freedb-server" arg="hostname">
      the FreeDB server name to query for metadata
    </option>
    <option long="freedb-port" arg="port">
      the FreeDB port to query for metadata
    </option>
    <option long="no-freedb">
      don't query FreeDB for metadata
    </option>
    <option short="D" long="default">
      When multiple metadata choices are available,
      select the first one automatically.
      This option has no effect when used with -I
    </option>
  </options>
  <examples>
    <example>
      <description>
        Update track.flac to be track number 5 and have a
        track name of "Test Track".
      </description>
      <command>
        tracktag "--name=Test Track" --number=5 track.flac
      </command>
    </example>
    <example>
      <description>
        Add ISRC metadata from the disc in /dev/cdrom to all MP3 files in
        the current directory
      </description>
      <command>
        cdrdao read-toc --device /dev/cdrom album.toc
      </command>
      <command>
        tracktag --cue=album.toc *.mp3
      </command>
    </example>
  </examples>
</manpage>
