YaRET - Yet another Ripper Encoder Tagger

       This manual page was written by Marco Nenciarini <mnencia@debian.org>, for the Debian project (but may be
       used by others).

YaRET 2.1.0 (Jul 10, 2003)                          June 2004                                           YARET(1)

       This  manual  page  documents  briefly  the  yaret  command.  This manual page was written for the Debian
       distribution because the original program does not have a manual page.

       YaRET is a Perl script that automates the ripping, normalization, and encoding of CDs. It  supports  CDDB
       very  well  via the Perl Audio::CD module, and also can work with your favorite ripper/normalizer/encoder
       (e.g., cdparanoia, cdda2wav, normalize, etc.)  It  supports  useful  features  like  multiple  concurrent
       encoders  and an easy to use configuration file that lets you customize YaRET to your taste (such as file
       naming based on the CDDB information).

       Please  see  your  ~/.yaretrc  file  (auto-generated  at  the  first  time  execution)  as  well  as  the
       /usr/share/doc/yaret/README   and   yaretrc   files   that   came   with   YaRET   (perhaps   located  in
       /usr/share/yaret/dot-yaretrc) for more information about configuring the many features that  YaRET  comes
       with.

       YaRET - Yet another Ripper Encoder Tagger

       These  programs  follow  the  usual  GNU  command line syntax, with long options starting with two dashes
       (`-').  A summary of options is included below.

       [General]

       -h, --help
              Display this help (also -?)

       -v, --version
              Display the version

       --option_only
              Display configuration data

       -f, --include=<file>
              Include this file as configuration data (in addition to ~/.yaretrc and any command  line  options)
              (also --conf_file)

       --cddb_file=<file>
              Include  this CDDB information in addition to that obtained from the CDDB query (in same format as
              both --cddb_dump and --cddb_out produce)

       --max_fork=<value>
              Maximum number of normalizers and encoders forked (per type)

       --size_order
              Sorts tracks in order of size, completing smaller ones first.

       [Display]

       --date Display the start/end times

       --color
              Use color

       --alarm
              Send beeps when completed

       --clear
              Clear the screen

       --quiet
              Do not display anything except errors

       [Paths and Filenames]

       --root_final=<path>
              Where to place the results

       --root_work=<path>
              Where to work on the results

       --output_name=<pattern>
              How to name the final file

       --output_path=<pattern>
              Path under root_final to place file

       --output_track_num_format=<format>
              Specifies a printf format for the track numbering, e.g. "%02d"

       --output_trans=<regexp>
              Specifies a regular expression that effects the output of what filename is  generated,  e.g.  "tr/
              /_/"

       [CDDB Overrides]

       --global==<attr>=<val>
              e.g. ARTIST=Bare Naked Ladies (Make sure to use escapes or quotes) (also --cddb_global)

       --track==<tracknum>=[<attr>=<val> ]*
              e.g. 14=TRACK=Alone ARTIST=Heart (Make sure to use escapes or quotes)

       --cddb_dump=<file>
              Dump cddb information to <file> then exit (no editing, encoding, etc.)

       --cddb_out=<pattern>
              After  the  entire  process is completed, output the cddb information to <pattern>.  This filename
              works with the same pattern rules as the other output files, however some keyword may may  not  be
              available. The information saved will reflect any editing.

       --confirm
              Confirm cddb information (also --cddb_confirm) Use --noconfirm to turn off.

       [Ripper]

       -r, --ripper=<label>
              Which ripper to use (cdparanoia and cddawav have already been defined) (also --ripper_use)

       --ripper_command==<label>=<command>
              The <command> associated with <label>

       -d, --device=<device>
              CDROM Device to use, default is /dev/cdrom (also --ripper_device)

       --skip=<tracknumlist>
              Skip these tracks, e.g. 3,10-13 (also --ripper_skip)

       --auto_skip=<seconds>
              Auto skip tracks that do not grow after <seconds> (also --ripper_auto_skip)

       --min_space=<megabytes>
              Do not start ripping a new track unless this much space is free (also --ripper_min_space)

       --ripper_nice=<nice>
              Nice the ripper process to <nice>

       [Normalize]

       --normalize=<label>
              As --ripper (normalize has already been defined)

       --normalize_type=<value>
              TRACK/ALBUM  normalization,  ALBUM  uses  a  larger amount of work space, and cannot start working
              until all ripping is done.

       --normalize_command==<label>=<command>
              As --ripper_command--normalize_nice=<nice>
              As --ripper_nice

       [Encoder]

       -e, --encoder=<label>
              As --ripper except you may enable multiple (but make sure you use the ENCODE keyword  in  --output
              options) (lame and bladeenc have already been defined)

       --encoder_command==<label>=<command>
              As --ripper_command--bitrate==<label>=<bitrate>
              Set bitrate for <label> encoder (also --encoder_bitrate)

       --quality==<label>=<quality>
              Set quality for <label> encoder (also --encoder_quality)

       --extension==<label>=<value>
              Set extension for <label> encoder, default is ".mp3" (also --encoder_extension)

       --encoder_nice=<nice>
              As --ripper_nice

cdparanoia(1), cdda2wav(1), oggenc(1), flac(1), metaflac(1), normalize(1).

yaret [options]
       yaret [--help|--version|--option_only]