<?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>tracksplit</utility>
  <author>Brian Langenberger</author>
  <section>1</section>
  <name>split audio track</name>
  <title>Audio File Splitter</title>
  <synopsis>[OPTIONS] &lt;track 1&gt;</synopsis>
  <description>
    tracksplit splits an audio track into several smaller tracks.
  </description>
  <options>
    <option short="h" long="help">show a list of options and exit</option>
    <option short="I" long="interactive">
      edit metadata in interactive mode prior to splitting file
    </option>
    <option long="cue" arg="filename">
      the cuesheet to use for splitting track
    </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="t" long="type" arg="type">
      The audio format to convert the split tracks to.
      For a list of available audio formats, try: -t help.
    </option>
    <option short="q" long="quality" arg="quality">
      The desired quality of the split tracks.
      For a list of available quality modes for a given format, try: -q help
    </option>
    <option short="d" long="dir" arg="directory">
      The target directory for the split tracks.
      If none is given, the current working directory is used.
      If the target directory does not exist,
      it will be created automatically.
    </option>
    <option long="format" arg="string">
      The format string to use for new filenames.
      Template fields are replaced with metadata values when
      new tracks are created.  All other text is left as-is.
      If this option is omitted, a default format string is used.
    </option>
    <option short="j" long="joint" arg="processes">
      The maximum number of tracks to convert at one time.
      If one has multiple CPUs or CPU cores, allowing
      tracksplit(1)
      to use all of them simultaneously can greatly increase encoding speed.
    </option>
  </options>
  <options category="CD lookup">
    <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>
  <options category="metadata">
    <option long="album-number" arg="number">
      the album number of the tracks' CD,
      if they are in one in a series of albums
    </option>
    <option long="album-total" arg="number">
      the total number of albums in the tracks' CD set,
      if it is one in a series of albums
    </option>
    <option long="replay-gain">
      add ReplayGain metadata to newly created tracks
    </option>
    <option long="no-replay-gain">
      do not add ReplayGain metadata to newly created tracks
    </option>
  </options>
  <examples>
    <example>
      <description>
        Split CDImage.wav into several MP3 files using the cuesheet
        CDImage.cue:
      </description>
      <command>
        tracksplit -t mp3 --cue=CDImage.cue CDImage.wav
      </command>
    </example>
    <example>
      <description>
        Obtain CDImage.cue using the cdrdao(1) utilities:
      </description>
      <command>
        cdrdao read-toc --device /dev/cdrom CDImage.toc
      </command>
      <command>
        toc2cue CDImage.toc CDImage.cue
      </command>
    </example>
  </examples>
</manpage>
