.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "WHIPPER-CD-RIP" "1" "2021" ""
.SH NAME
whipper-cd-rip \- Rips a CD
.SH SYNOPSIS
.nf
whipper cd rip [\fBoptions\fP]
whipper cd rip \fB\-h\fP
.fi
.sp
.SH OPTIONS
.nf
\fB\-h\fP | \fB\-\-help\fP
.in +2
Show this help message and exit
.in -2
.fi
.sp
.nf
\fB\-R\fP \fI<RELEASE_ID>\fP | \fB\-\-release\-id\fP \fI<RELEASE_ID>\fP
.in +2
MusicBrainz release id to match to (if there are multiple)
.in -2
.fi
.sp
.nf
\fB\-p\fP | \fB\-\-prompt\fP
.in +2
Prompt if there are multiple matching releases
.in -2
.fi
.sp
.nf
\fB\-c\fP \fI<COUNTRY>\fP | \fB\-\-country\fP \fI<COUNTRY>\fP
.in +2
Filter releases by country
.in -2
.fi
.sp
.nf
\fB\-L\fP \fI<LOGGER<\fP | \fB\-\-logger\fP \fI<LOGGER>\fP
.in +2
Logger to use
.in -2
.fi
.sp
.nf
\fB\-o\fP \fI<OFFSET>\fP | \fB\-\-offset\fP \fI<OFFSET>\fP
.in +2
Sample read offset
.in -2
.fi
.sp
.nf
\fB\-x\fP | \fB\-\-force\-overread\fP
.in +2
Force overreading into the lead\-out portion of the disc. Works only if
the patched cdparanoia package is installed and the drive supports this
feature
.in -2
.fi
.sp
.nf
\fB\-O\fP \fI<OUTPUT_DIRECTORY>\fP | \fB\-\-output\-directory\fP \fI<OUTPUT_DIRECTORY>\fP
.in +2
Output directory; will be included in file paths in log
.in -2
.fi
.sp
.nf
\fB\-W\fP \fI<WORKING_DIRECTORY>\fP | \fB\-\-working\-directory\fP \fI<WORKING_DIRECTORY>\fP
.in +2
Working directory; whipper will change to this directory and files will
be created relative to it when not absolute
.in -2
.fi
.sp
.nf
\fB\-\-track\-template\fP \fI<TRACK_TEMPLATE>\fP
.in +2
Template for track file naming
.in -2
.fi
.sp
.nf
\fB\-\-disc\-template\fP \fI<DISC_TEMPLATE>\fP
.in +2
Template for disc file naming
.in -2
.fi
.sp
.nf
\fB\-U\fP | \fB\-\-unknown\fP
.in +2
whether to continue ripping if the CD is unknown
.in -2
.fi
.sp
.nf
\fB\-\-cdr\fP
.in +2
whether to continue ripping if the disc is a CD\-R
.in -2
.fi
.sp
.nf
\fB\-C\fP | \fB\-\-cover\-art\fP \fIfile embed complete\fP
.in +2
Fetch cover art and save it as standalone file, embed into FLAC files or
perform both actions: file, embed, complete option values respectively
.in -2
.fi
.sp
.nf
\fB\-r\fP | \fB\-\-max\-retries\fP \fI<RETRIES>\fP
.in +2
Number of rip attempts before giving up if can\(aqt rip a track. This
defaults to 5; 0 means infinity.
.in -2
.fi
.sp
.nf
\fB\-k\fP | \fB\-\-keep\-going\fP
.in +2
continue ripping further tracks instead of giving up if a track can\(aqt be
ripped
.in -2
.fi
.sp
.SH TEMPLATE SCHEMES
.nf
Tracks are named according to the track template, filling in the variables
and adding the file extension. Variables exclusive to the track template are:
.fi
.sp
.nf

.fi
.sp
.nf
\- %t: track number
\- %a: track artist
\- %n: track title
\- %s: track sort name
.fi
.sp
.nf
Disc files (.cue, .log, .m3u) are named according to the disc template,
filling in the variables and adding the file extension. Variables for both
disc and track template are:
.fi
.sp
.nf

.fi
.sp
.nf
\- %A: release artist
\- %S: release sort name
\- %B: release barcode
\- %C: release catalog number
\- %c: release disambiguation comment
\- %d: release title (with disambiguation)
\- %D: disc title (without disambiguation)
\- %I: MusicBrainz Disc ID
\- %M: total number of discs in the chosen release
\- %N: number of current disc
\- %T: medium title
\- %y: release year
\- %r: release type, lowercase
\- %R: release type, normal case
\- %x: audio extension, lowercase
\- %X: audio extension, uppercase
.fi
.sp
.nf
Paths to track files referenced in .cue and .m3u files will be made
relative to the directory of the disc files.
.fi
.sp
.nf
All files will be created relative to the given output directory.
Log files will log the path to tracks relative to this directory
.fi
.sp
.SH SEE ALSO
.sp
whipper(1), whipper\-cd(1), whipper\-cd\-info(1)
.SH AUTHOR
Louis-Philippe Véronneau
.\" Generated by docutils manpage writer.
.