YARET(1)

πŸ’– YARET(1) β€” bestie edition πŸ’–

okay so first things first: this is the manual page for yaret, living in the User Commands section of the manual, and I'm about to tell you everything about it, no gatekeeping, no cap. 🫢


✨ NAME ✨

YaRET β€” Yet another Ripper Encoder Tagger. iconic name, honestly. πŸ’…


πŸŽ€ SYNOPSIS πŸŽ€

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

that's it, that's the whole vibe check. 🌸


πŸ¦‹ DESCRIPTION πŸ¦‹

so this manual page documents yaret briefly, bestie β€” just the highlights. and yes, this page was written for the Debian distribution specifically because the original program literally does not have a manual page. so we made one. you're welcome. πŸ’…

YaRET is a Perl script that automates the ripping, normalization, and encoding of CDs. the way it supports CDDB so well via the Perl Audio::CD module?? obsessed. πŸ₯° and it can also work with your favorite ripper / normalizer / encoder (e.g., cdparanoia, cdda2wav, normalize, etc.) β€” so you're not locked into anyone's fave, you get to choose. main character energy. ✨

it also has genuinely useful features like:

  • multiple concurrent encoders (yes, plural, it's giving multitasking queen πŸ‘‘)
  • an easy to use configuration file that lets you customize YaRET to your taste β€” like file naming based on the CDDB information πŸ’–
πŸ“– please go look at your ~/.yaretrc file (it's auto-generated the first time you execute it, cute) AND the /usr/share/doc/yaret/README and yaretrc files that came with YaRET (perhaps located in /usr/share/yaret/dot-yaretrc) for more info about configuring all the many features YaRET comes with. fr fr, read them, they're useful.

πŸ’… OPTIONS πŸ’…

okay so these programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). a summary of options is included below. let's get into it. 🌈

🌟 [General] 🌟

  • -h, --help β€” displays this help (also -?)
  • -v, --version β€” displays the version
  • --option_only β€” displays 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 🌈

go check out the friends of the family, bestie: 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). πŸ’œ


and that's the whole page, periodt. πŸ’… this was YaRET 2.1.0 (Jul 10, 2003), with the manual dated June 2004, and the whole thing lives under YARET(1). slay, bye bestie πŸŽ€βœ¨πŸ«Ά

πŸ“¦ where this page comes from