Manual Reference Pages - DAGRAB (1)
dagrab - dumps digital audio from cdrom
key length ]
-H host ]
-P port ]
-D dir ]
dagrab is a program for reading audio tracks from a cdrom drive into
RIFF WAVE (.wav) sound files.
It should work with any cdrom drive, provided that digital
audio extraction is supported from both the drive and its
For an index of cdrom drives that support digital audio
extraction, take a look at these URLs:
-h will print the help screen
-i prints out the track list from the current cd. This includes
track number, lba start and length, type of track, its time
duration and needed length when dumped to disk.
device sets the cdrom device name. Default is /dev/cdrom (if you havent done
already: symlinking of your cdrom device to /dev/cdrom is standard)
-a dumps all tracks and ignores the optional track list.
-v enables the verbose mode of dagrab. It will print warning
messages to stderr while delivering some useful information to
stdout. E.g. the rest time and speed factor will be displayed
while dumping a track.
file sets the output name for dumping tracks. If the file exists,
it will be overwritten.
In non CDDB naming mode (-N option not used), you can embed %02d in the string which
will be replaced with the track number (counting from 1).
Default is "track%02d.wav".
In CDDB naming mode (-N option) you may also embed variables (see below).
In this case the default value is "@firstname.lastname@example.org".
overlap sets the number of sectors which are used for jitter correction.
Shouldnt be too high or you will get "jumps" in your dump.
The default value is 3.
sectors will be read per request from the cdrom driver. (Read the note
on IDE drives below)
key length is the number of keys which must be equal for a match in
jitter correction. Default value is 12.
retries sets the number of times to reread sectors before a
jitter error is given. Default is 40 times.
offset sets the maximum offset to search for jitter correction. Default is 12.
mode gives the standard mode for files. Also existing files will
be chmod to this value. Default is 0660.
command will be executed after dumping a track. This can be used to automize
converting the dumped data, for example. You can embed %s in the
command which will be substituted with the filename of the track file.
In CDDB mode you may also embed variables (see below).
-s enables checking for free space before dumping the track to a file.
However, if the file exists before, it will be overwritten (read:
deleted) and dagrab skips to the next track.
-p enables converting the stereo audio data to mono.
This doesnt select a special channel but the mixed information
of both audio channels.
-C enables the use of cddbp protocol to retrieve disk info.
-S causes the program to look for cddb data in remote server and to save it in
the local database, wich for default is located in the
xmcd library directory.Implies
-N gives to each track the name reported by cddb; overrides
-f. It does not enable cddbp.
host is the remote cddb server, defaults to cddb.like.it.
port is the port to connect to on the remote server, defaults to 888.
dir sets the base directory of the local cddb database;
it defaults to $XMCD_LIBDIR/cddb or /usr/lib/X11/xmcd/cddb if not defined.
When CDDB mode is enabled, you can use variables bound to track data both for the track name and the filter.
case use lowcase names for "filename friendly" filtered values (like "ME-I_DON_T" insread of "ME/I DONT")
upcase names returns unchanged values (shell escaped when used in a filter command).
Here is a list of the available variables:
@TRK Track name
@FDS Full disk name (usually author/title)
@AUT Disk author (guessed, supposes that ful disk name is author/title)
@DIS Disk name (guessed, as above)
@NUM Track number
Gaining more speed with IDE drives
Edit /usr/src/linux/drivers/block/ide-cd.c and change the value
defined for CDROM_NBLOCKS_BUFFER near line 202 to a higher value.
A value of 32 works for me with a Toshiba XM-6201B (256KB buffer).
After installing the new kernel, you may use the
-n sectors option to tell dagrab to read more sectors
dagrab should work with all drives supporting digital
audio extraction (as long as linux kernel drivers supports that too).
IDE drives are alwais supported by kernel, but many doesnt support
audio extracton;SCSI drives usually does, but there isnt a standard
way to do it, so often the kernel doesnt support that feature.
If you need to extract audio from a SCSI drive, you can try with CDDA2WAV.
dagrab uses the term MB for MByte (2^20 bytes ==
1024^2 bytes == 1,048,576 bytes)
Legal note: This program may not be used to circumvent
Please send bug reports (fixes are even more welcome) to Marcello
Urbani <email@example.com> or Sascha Schumann <firstname.lastname@example.org>
Main author of dagrab is Marcello Urbani <email@example.com>.
Patches, comments, bug reports etc are directed to him.
Author of some dagrab extensions and man page is
Sascha Schumann <firstname.lastname@example.org>
|dagrab ||DAGRAB (1) ||24/06/1999 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.