.\" This documentation was last modified by .\" Martin Bayer .\" on Sun Jul 20 11:06:48 CEST 2003 .\" .\" Comments and suggestions are welcome. .\" .TH dekagen 1 2003\-07\-19 .SH NAME dekagen \- a frontend to rip, convert and name MP3/Ogg .SH SYNOPSIS .B dekagen .br .B dekagen \-\-version .SH DESCRIPTION .B dekagen is an interactive script that automates the whole process of ripping data from music compact discs (CD), the naming of the files, their converting into MP3 or Ogg\-Vorbis format, and the labelling of the MP3 files with an ID3 tag. .B dekagen uses .BR dialog (1) for a user interface that is intended to be "intuitive". .P Music data is read from CDs using .BR cdda2wav (1), .BR cdparanoia (1), .BR dagrab (1), or .BR tosha (1), and stored on your harddisk in wav\-format. After this, the wav\-data is converted into MP3 format using .BR 8hz-mp3 , .BR bladeenc , .BR l3enc , .BR lame (1), .BR mp3enc , or .BR notlame , or into Ogg-Vorbis format using .BR oggenc (1). .BR cda (1), which comes within the .BR xmcd (1) package, is used for CDDB lookups. To label the MP3 files with ID3 tags, .BR id3ed , .BR id3tag , .BR id3tool (1), .BR mp3info (1), or the built\-in capabilities of some converters are used. .SH OPTIONS Using any command line option will cause dekagen to print its version number and exit: .TP .BR \-V ", " \-\-version Print program version and exit. .P All configuration is done interactively from the "Preferences" menu in the program: .TP .B Change working directory Full path to the directory in which all ripping and encoding will be done. .B dekagen will check whether you have write-access to it. .TP .B Choose ripper Your preferred ripping tool. .B dekagen will check whether it is installed and executable. .br If you do not wish to rip any data, but to convert only already existing wav-files, choose "none" here. .TP .B Choose encoder Your preferred MP3-/Ogg-Vorbis-converter. .B dekagen will check whether it is installed and executable. .br If you do not wish to convert any data, but to rip only wav-files from audio CDs, choose "none" here. .TP .B Choose ID3 tag tool Your preferred ID3 tagging utility. .B dekagen will check whether it is installed and executable, and whether it can be used together with the converter you chose. .br When using .BR oggenc (1) as encoder, you can only choose either "none" or "built-in" here. Besides this, the "built-in" option can be used only together with .BR lame (1) or .BR notlame. .br If you do not wish to have your MP3-/Ogg-files tagged, or if you do not have an ID3 tagging utility installed, choose "none" here. .TP .B Toggle between manual or CDDB naming Manual naming is used by default. If you have .BR cda (1) installed and configured on your system correctly, you may choose "cddb" here, avoiding manual naming for all the files you are going to rip and encode. .BR cda (1) will connect to the CDDB, either locally, which requires an already existing entry in your local CDDB for the CD you are going to rip and encode, or remotely, which requires a network connection. .TP .B Set XMCD_LIBDIR variable for cda Some versions of .BR cda (1) require the .I XMCD_LIBDIR environment variable to be set. This can be done here by entering the full path to the directory .BR cda (1) resides in. If you unset the option by entering a blank line here, the value of the system's .I XMCD_LIBDIR environment variable will not be changed. .TP .B Set file naming convention Your preferred file naming convention. Options 5, 6, and 7 cannot be used with various artists CDs. .TP .B Rip whole CD Enable this option if you want to have the whole CD, i.e. any title on it, to be ripped and encoded. .TP .B Set small hard disk option By default, .B dekagen will rip all selected songs, putting their encoding into a queue in the background. If you have only a small hard disk (and only a rather weak processor), you can enable this option. It will make .B dekagen to rip one song and than encode it, before ripping the next one. .TP .B Select your CD-ROM device Full path to the device .B dekagen should use for ripping. .B dekagen will check whether it exists. .TP .B Set nominal bitrate for the encoded MP3/Ogg Choose the encoding bitrate for your MP3-/Ogg-file. The values available are limited to those settings that all encoders supported by .B dekagen understand. .br When using an encoder that uses variable bitrate (VBR) encoding by default, like .BR oggenc (1) does, this value is used for an .I average encoding bitrate, without disabling the default VBR encoding. Thus, setting this option allows you to determine the quality and the size of the encoded audio file, without causing it to be of a quality inferior to that it would have if a corresponding "quality level" setting was used instead. .SH REQUIREMENTS Either .BR cdda2wav (1), .BR cdparanoia (1), .BR dagrab (1), or .BR tosha (1) to rip data from the music CD, and either .BR 8hz-mp3 , .BR bladeenc , .BR l3enc , .BR lame (1), .BR mp3enc , or .B notlame for conversion into MP3 format, or .BR oggenc (1) for conversion into Ogg\-Vorbis format. .br To avoid manual naming for all the files, .BR xmcd (1) for CDDB lookups is recommended, and .BR id3ed , .BR id3tag , .BR id3tool (1), or .BR mp3info (1) to label the MP3 files with ID3 tags. .P ID3 tagging utilities are not needed when using .BR lame (1) or .B notlame as converters, because these programs have a built-in ID3 tagging capability. Labelling of the Ogg\-Vorbis files is always done by .BR oggenc (1), because Ogg-Vorbis has its own tagging system, so no ID3 tagging utilities have to be used together with .BR oggenc (1). .SH AUTHOR Current maintainer and primary download location for .B dekagen is: .br Martin Bayer .br .UR http://userpage.fu-berlin.de/~mbayer/tools/dekagen.html .UE .SH SEE ALSO .BR cda (1), .BR cdda2wav (1), .BR cdparanoia (1), .BR dagrab (1), .BR dialog (1), .BR id3tool (1), .BR lame (1), .BR mp3info (1), .BR oggenc (1), .BR tosha (1) .SH COPYRIGHT This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for details. .P Please note that some of the third-party software supported by .B dekagen might have different copyright terms or might even be subject to patent restrictions.