<?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>trackcat</utility>
  <author>Brian Langenberger</author>
  <section>1</section>
  <name>concatenate two or more audio tracks</name>
  <title>Audio Concatenator</title>
  <synopsis>[OPTIONS] &lt;track 1&gt; [track 2] [track 3] ...</synopsis>
  <description>
    trackcat combines the audio data from two or more audio tracks
    into a single output track.
  </description>
  <options>
    <option short="h" long="help">show a list of options and exit</option>
    <option short="I" long="interactive">
      edit metadata and encoding options in interactive mode
      prior to converting tracks
    </option>
    <option long="cue" arg="filename">
      a cuesheet to embed in the output file
    </option>
    <option long="add-cue">
      Embed a cuesheet in the output file using the track lengths
      as index points.
      This option assures a concatenated file can be re-split
      into its original tracks even if the original
      cuesheet is not available.
    </option>
    <option short="V" long="verbose" arg="verbosity">
      The level of output to display.
      Choose between 'normal', 'quiet' and 'debug'.
    </option>
  </options>
  <options category="encoding">
    <option short="o" long="output" arg="filename">
      the output filename of the concatenated track
    </option>
    <option short="t" long="type" arg="type">
      the audio format of the concatenated track;
      for a list of available audio formats, try: -t help
    </option>
    <option short="q" long="quality" arg="quality">
      the desired quality of the concatenated track;
      for a list of available quality modes for a given format, try: -q help
    </option>
  </options>
  <options category="CD lookup">
    <option short="M" long="metadata-lookup">
      perform metadata lookup for converted tracks
    </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>
        Convert all of the WAVE files in sourcedir to a single
        FLAC file, album.flac at the highest possible compression
        (quality 8):
      </description>
      <command>trackcat -t flac -q 8 -o album.flac sourcedir/*.wav</command>
    </example>
  </examples>
</manpage>
