<?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>cdda2track</utility>
  <author>Brian Langenberger</author>
  <section>1</section>
  <name>extract audio files</name>
  <title>Compact Disc Extractor</title>
  <synopsis>[OPTIONS] [track 1] [track 2] ...</synopsis>
  <description>
    cdda2track extracts audio files from a compact disc and
    encodes them to tracks.
    If track numbers are given, extracts only those tracks.
    Otherwise, extracts the entire disc.
  </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 extracting disc
    </option>
    <option short="c" long="cdrom" arg="cdrom">
      the CD-ROM device to extract audio from
    </option>
    <option short="s" long="speed" arg="speed">
      the speed to extract audio data at
    </option>
    <option short="V" long="verbose" arg="verbosity">
      The level of output to display.
      Choose between 'normal', 'quiet' and 'debug'.
    </option>
  </options>
  <options category="extraction">
    <option short="t" long="type" arg="type">
      The audio format of the extracted audio tracks.
      For a list of available audio formats, try: -t help.
    </option>
    <option short="q" long="quality" arg="quality">
      The desired quality of the extracted 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 extracted 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>
  </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 this CD, if it is one in a series of albums
    </option>
    <option long="album-total" arg="number">
      the total number of albums in this CD's 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>
  <element name="accuraterip">
    <p>
      Extracted tracks are automatically verified against
      AccurateRip's online database.
      The confidence level is the number of other people
      who have the same rip, so a larger value indicates
      one's own rip is consistent with those of others.
      However, not finding one's rip in the AccurateRip
      database does not necessarily mean the rip is bad;
      the CD may be new, rare, or a different
      pressing than the one in the database.
    </p>
  </element>
  <examples>
    <example>
      <description>
        Extract all of the tracks from /dev/cdrom as FLAC files
        at the default quality:
      </description>
      <command>
        cdda2track -t flac -c /dev/cdrom
      </command>
    </example>
  </examples>
</manpage>
