---
name: "cwcdr"
section: "1"
platform: "linux"
package: "cwcdr"
version: "2.0.2"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/cwcdr"
---

# cwcdr(1)

Chez Wam CD Ripper

## NAME

cwcdr - Chez Wam CD Ripper

## SYNOPSIS

**cwrrd** \[ **options** \]

## DESCRIPTION

**cwcdr** is a powerful command line CD ripper tool. You can define any commands you want then easily extend the possibilies of this tool.

Internely **cwcdr** uses a rip file which defines each tracks of the album. Its format is quite simple.

```
	<num>|<artist>|<album>|<year>|<title>|<filename>
```

Sections mean in order:

- 1\.

  The track number

- 2\.

  The artist name

- 3\.

  The album name

- 4\.

  The track year

- 5\.

  The tack name

- 6\.

  The tack file name

  **Note:** The last section (filename) is optional and is only used when converting track names to UN\*X legal filenames.

## OPTIONS

- **--rip-file \| r file**

  Set file as rip info file instead of *rip.rip*

- **--device \| -d device**

  Set device as cdrom device.

- **--charset \| -C charset**

  Set charset when converting track titles to filenames.

- **--year \| -y year**

  Set year as disc year.

- **--performer \| -P name**

  Set name as disc performer. This option is used for CD-Text information when burning a CD.

- **--prefix \| -p**

  Set prefix for each file or directory. This affects the \<prefix\> macro of **cwcdr** configuration file.

- **--tracks \| -t tracks**

  Only affects tracks when performing an action. Use : for separating tracks and - to specify a range.

- **--read-rip-from-file \| -F**

  Use rip info file instead of fetching info via CDDB.

- **--dummy \| -u**

  Dummy mode run.

- **--verbose \| -V**

  Run in verbose mode.

- **--display-rip-info \| -d**

  Display rip information file on standard output.

- **--write-rip-info \| -W**

  Save the rip info file.

- **--write-cdda-info \| -I**

  Write CDDA info file

- **--make-dirs \| -m**

  Create directories (*\<artist\>/\<album\_title\>*) if they do not exist.

- **--change-dir \| -g**

  Go to directory (*\<artist\>/\<album\_title\>*).

- **--daemon \| -n**

  Run in deamon mode.

- **--help \| -h**

  Display help information.

## CREATING COMMANDS

There are 2 kind of user-commands: those which are looped and those which are not.

A looped command is executed once on each track (defined in the \<commands\> block). A non-looped command is executed once on all tracks (defined in the \<one\_run\_commands\> block).

Each user commands are listed when invoking the ripper using the **help** command.

Use a backslash to escape the $ character.

**Note:** Non-looped commands are run **before** the rip information file is loaded. Therefore no expansion is possible withing such commands.

### VARIABLE EXPANSION IN LOOPED COMMANDS.

*\<album\>* The album's name.

*\<artist\>* The artist's name.

*\<date\>* The track's year.

*\<ext\>* Encoded files' extension (used when moving file for example).

*\<file\>* The track's file name (deducted from its name).

*\<file\_orig\>* The original track's file name (the last section in the rip file info). Useful for moving files.

*\<prefix\>* The prefix used when moving files for example.

*\<title\>* The track's title.

*\<tracknumber\>* The track's number in the playlist.

**Note:** If the variable is in CAPITALS, its containt is converted to UNI\*X byte-clean string before being expanded.

## CONFIGURATIN FILE

### CDDB OPTIONS

These options are defined in the **CDDB**(3) man page. They fits under the \<cddb\> block in the configuration file.

*CDDB\_HOST* Define the CDDB server.

*CDDB\_MODE* Define the CDDB protocole mode. Its value can eigther be cddb or http.

*CDDB\_PORT* Define the port to use. This option does not seem to work fine. You should leave it blank.

*CD\_DEVICE* The name of the CD-ROM device.

*HELLO\_ID* The hello greatings send to the server.

*PROTO\_VERSION* The CDDB protocole version.

*HTTP\_PROXY* The HTTP proxy gateway.

*FW* Set to "1" if you are behind a firewall.

### CDDA OPTIONS

These options are use to create the CDDA file used to burn an audio CD. They are defined under the \<cdda\> block in the configuration file.

*header* This block is put once at the begining of the CDDA file.

*track* This block is looped for each track.

## SEE ALSO

[**cdda2wav**(1)](/cdda2wav/1.md), [**cdparanoia**(1)](/cdparanoia/1.md), [**cdrdao**(1)](/cdrdao/1.md), [**mp3info**(1)](/mp3info/1.md), [**mpg321**(1)](/mpg321/1.md), [**ogg123**(1)](/ogg123/1.md), [**oggenc**(1)](/oggenc/1.md), [**ogginfo**(1)](/ogginfo/1.md), [**vorbiscomment**(1)](/vorbiscomment/1.md),

## DAEMON MODE

**cwcdr** can be run in **daemon** **mode**. This means it will be run normally except that the rip info file is provided via a pipe defined in the configuration file under the variable pipe\_file.

To create this fifo, just run the command:

```
	$ mkfifo file_name
```

from the command line.

To run **cwcdr** with all options you need (please note that only **looped commands** are accessible in this mode). Then you can provide the rip info file location by simply echoing it's absolute path in the fifo.

Sending quit to the fifo will make **cwcdr** to exit.

## FILES

*/etc/cwcdr.conf*

*cwcdr.conf*

*$HOME/.cwcdr.conf*

## BUGS

Actually no bugs are reported.

## AUTHOR

**cwcdr** was written by Sebastien Gross \<seb+cwcdr@chezwam.org\>.