---
name: "whipper-cd-rip"
section: "1"
platform: "linux"
package: "whipper"
version: "0.10.0-9"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/whipper-cd-rip"
---

# whipper-cd-rip(1)

Rips a CD

## Name

whipper-cd-rip - Rips a CD

## Synopsis

```
whipper cd rip [options]
whipper cd rip -h
```

## Options

```
-h | --help
Show this help message and exit
```

```
-R <RELEASE_ID> | --release-id <RELEASE_ID>
MusicBrainz release id to match to (if there are multiple)
```

```
-p | --prompt
Prompt if there are multiple matching releases
```

```
-c <COUNTRY> | --country <COUNTRY>
Filter releases by country
```

```
-L <LOGGER< | --logger <LOGGER>
Logger to use
```

```
-o <OFFSET> | --offset <OFFSET>
Sample read offset
```

```
-x | --force-overread
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
```

```
-O <OUTPUT_DIRECTORY> | --output-directory <OUTPUT_DIRECTORY>
Output directory; will be included in file paths in log
```

```
-W <WORKING_DIRECTORY> | --working-directory <WORKING_DIRECTORY>
Working directory; whipper will change to this directory and files will
be created relative to it when not absolute
```

```
--track-template <TRACK_TEMPLATE>
Template for track file naming
```

```
--disc-template <DISC_TEMPLATE>
Template for disc file naming
```

```
-U | --unknown
whether to continue ripping if the CD is unknown
```

```
--cdr
whether to continue ripping if the disc is a CD-R
```

```
-C | --cover-art file embed complete
Fetch cover art and save it as standalone file, embed into FLAC files or
perform both actions: file, embed, complete option values respectively
```

```
-r | --max-retries <RETRIES>
Number of rip attempts before giving up if can't rip a track. This
defaults to 5; 0 means infinity.
```

```
-k | --keep-going
continue ripping further tracks instead of giving up if a track can't be
ripped
```

## Template schemes

```
Tracks are named according to the track template, filling in the variables
and adding the file extension. Variables exclusive to the track template are:
```

```

```

```
- %t: track number
- %a: track artist
- %n: track title
- %s: track sort name
```

```
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:
```

```

```

```
- %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
```

```
Paths to track files referenced in .cue and .m3u files will be made
relative to the directory of the disc files.
```

```
All files will be created relative to the given output directory.
Log files will log the path to tracks relative to this directory
```

## See Also

[whipper(1)](/whipper/1.md), [whipper-cd(1)](/whipper-cd/1.md), [whipper-cd-info(1)](/whipper-cd-info/1.md)

## Author

Louis-Philippe Véronneau