man cwcdr (Commandes) - 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), cdparanoia(1), cdrdao(1), mp3info(1), mpg321(1), ogg123(1), oggenc(1), ogginfo(1), vorbiscomment(1),

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>.