NAME¶
YaRET - Yet another Ripper Encoder Tagger
SYNOPSIS¶
yaret [
options]
yaret [--help|--version|--option_only]
DESCRIPTION¶
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.
OPTIONS¶
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
SEE ALSO¶
cdparanoia(1),
cdda2wav(1),
oggenc(1),
flac(1),
metaflac(1),
normalize(1).
AUTHOR¶
This manual page was written by Marco Nenciarini <mnencia@debian.org>, for
the Debian project (but may be used by others).