CDDOIT
1.3
Written by Jose L. Diaz.
February/2002
Homepage: http://www.geocities.com/cddoit/index.html
Email: cddoit@yahoo.com
-----------------------------------------------------------------------

CDDOIT is a Bash script frontend under Linux that allows the creation of
audio/data CD's from WAV or MP3 files and others formats, MP3<->WAV conversion,
audio recording, playing and many others operations.

CDDOIT is designed to obtain the best quality in the creation of
audio CD's.

New additions in version 1.3:

	- New menu organization
	- Get RAW files from Audio-CD
	- Get AIFF files from Audio-CD
	- Get the whole Audio-CD in a single audio file in differents formats
	- Record audio in WAV format & 44100 Hz [CD copy format]
	- Record audio in specific formats
	- Audio conversion programs
	- Sleeptimer recording
	- Play many audio files
	- Multimedia kernel modules manager



CDDOIT allows the following functions:

	1. Direct Audio CD copy to CD-R
	2. WAV files to CD-R copy
	3. MP3 files to CD-R copy
	4. WAV files to CD-R DUMMY copy
	5. MP3/MPEG files to CD-R DUMMY copy
	6. Data-CD direct copy to CD-R: Get data image and copy
	7. Data-CD direct dummy copy to CD-R: Get data image and copy
	8. On-the-fly Data-CD copy to CD-R
	9. On-the-fly Data-CD dummy copy to CD-R
	10. Get data image
	11. Copy data image to CD-R
	12. Dummy copy data image to CD-R
	13. Audio+Data CD copy / Dummy copy";
	14. Get WAV files from Audio-CD
	15. Get MP3 files from Audio-CD
	16. Get WAV files from several Audio-CD
	17. Get MP3 files from several Audio-CD
	18. Record audio in WAV format
	19. Play WAV files
	20. Play MP3/MPEG files
	21. Convert MP3/MPEG files to WAV format
	22. Convert WAV files to MP3 format
	23. Convert no 44.100 Hz sample rate to 44.100 Hz in WAV files
	24. View size of a directory in MB
	25. View SCSI devices for CDRECORD
	26. View free space in Hard Disks
	27. View Audio-CD information
	28. Multisession audio CD copy
	29. LOOP device creation
	30. View image data files
	31. Convert audio file formats to CD copy audio file format
	32. Modify CDRECORD configuration file
	33. Close multisession audio CD
	34. Program audio recordings
    35. Program an audio recording";
	36. Delete an audio recording program";
	37. View audio recording programs";
	38. Cancel an audio recording program already started.";
	39. Manage of file names with spaces.
	40. Rename MP3 file names
	41. Date control in audio record programming
	42. Choose in DAO mode or not for recording
	43. Get RAW files from Audio-CD
	44. Get AIFF files from Audio-CD
	45. Get the whole Audio-CD in a single audio file in differents formats
	46. Record audio in WAV format & 44100 Hz [CD copy format]
	47. Record audio in specific formats
	48. Audio conversion programs
	49. Sleeptimer recording
	50. Play many audio files
	51. Multimedia kernel modules manager


CDDOIT uses these excellent programs:

	cdparanoia: Audio cd ripper
	cdrecord: CD'S copy
	mkisofs: Creation of image data files
	mpg123: MP3 Player
	bladeenc: MP3 Encoder
	sox: Audio converter
	at: scheduler

Not to have these programs it does not imply that CDDOIT cannot be
executed correctly, simply will not have that certain functionality.
Logically I recommend get all the programs (they don't take too
much disk space) for a complete functionality.
These programs you can obtain from Web sites like:

www.freshmeat.net
www.rpmfind.net




INSTALLATION:
----------------------------------------------------------

Before nothing, install the indicated programs above,
CDRECORD and CDPARANOIA are necesary.
Configure the /etc/cdrecord.conf file (see note n 4 and the
documentation of CDRECORD) 

1.
CDDOIT is distributed in a gzip/tar file: CDDOITx.xx.tar.gz 
To uncompress the file, run:

	gunzip CDDOITx.xx.tar.gz ; tar -xvf CDDOITx.xx.tar

CDDOIT have the following files:

	cddoit
	readme-cddoit

2.
Copy the executable file:

	cddoit

in your Bin directory: $HOME/bin
or in: /usr/local/bin

Be sure 'CDDOIT' have executable permissions.

When executing CDDOIT for the first time, will create a directory
called "CDDOIT" in your default directory ($home/CDDOIT) and
within it will create two directories: CDAUDIO and CDDATA that will
serve CDDOIT to store temp files.
These directories stay of automatic clean although there are options in
the menu of CDDOIT that allow to clean manually.
If these directories are erased, when you run CDDOIT they would become
again to create.
CDDOIT is designed to use it from a no-Root user. When it needs it
will request the ROOT password to make the operation and when finishing
the operation returns automatically to its user.
The copies to CD-R always are from ROOT (Maximum priority).

The reason of this method is avoid any possible disaster in your system
using ROOT user. There are many CDDOIT operations in which the
ROOT user is not necessary. 


NOTES:
-------------------------------------------------------------------

1.
In order to obtain perfect copies I don't recommend the
"on-the-fly" option.
In audio, the best way is get the WAV files from audio CD and copy
them to CD-R. Is slower but you make sure that the
quality is the best.

If you do not have a powerful computer neither a recorder with a great
buffer you don't make audio copies "on-the-fly". 


2.
The recording is in WAV format, 16 bits, stereo and 44.100 Hz rate, because
this is the CD-R copy format. Also CDDOIT record to 44.101 Hz, but you must
convert to 44.100 before the CD-R copy.
CDDOIT has an menu option to make conversions from no-44.100 Hz
to 44.100 Hz (Go to menu AUDIO, option n 4 to convert it).

Recording of audio is performed by SOX.
If your SOX version is older or the audio recording is not a good quality
try to 44101 Hz recording.


3.
The extraction of audio is made with CDPARANOIA. CDDOIT runs
CDPARANOIA by each track of the Audio CD (although it allows to obtain
all the audio tracks of the CD at once) since I have verified better
results with this method.
For that reason, in the direct copy, for example, it is necessary to
indicate the total
number of Audio CD tracks.
CDDOIT will show a listing with all
the tracks of the audio CD.


4.
In order to copy audio cd's CDDOIT it uses the configuration file of
CDRECORD for the copy, the file is: / etc/cdrecord.conf
You must to indicate device SCSI, the speed of recording and the size
of the buffer that will be used.
Go to menu OTHERS, oprtion 10 to modify the 'cdrecord.conf' file easy.
CDDOIT allows the visualization of SCSI devices that CDRECORD
recognizes.
Read the documentation of CDRECORD about it.


5.
CDRECORD uses only devices SCSI, reason why if you have a recorder
IDE/ATAPI you must have activated SCSI emulation to detects it.
In order to know if CDRECORD has detected devices executes the option
of menu that allows the visualization of the SCSI devices that CDRECORD
recognizes.
If CDRECORD does not detect your recorder, you must to activate SCSI
emulation. If your kernel is recent adding these lines to the
file  /etc/modules.conf:

options ide-cd ignore=hd?            # tell the ide-cd module to ignore hd? (? is your device letter)
alias scd0 sr_mod                    # load sr_mod upon access of scd0
pre-install sg     modprobe ide-scsi # before sg, load ide-scsi
pre-install sr_mod modprobe ide-scsi # before sr_mod, load ide-scsi

and this line to the / etc/lilo.conf file:

image=/boot/vmlinuz-2.2.XX-XX
	label=XXXX
	read-only
	root=/dev/hdXX
	append="hd?=ide-scsi"   <<<---- ADD THIS LINE
	
Where ? is the device letter of your CD-Recorder.

SCSI emulation would have to activate.
If even so the emulation does not activate I recommend you
read the
"CDWriting-howto" document which you can get it in www.linuxdoc.org
and the documentation of CDRECORD (the file "readme.atapi") 


6.
If you include CDDOIT in the menu through the menu editor of GNOME
or KDE, you must indicate that it is executed through a terminal, otherwise,
when executing it you will not be able to see it.
It remembers that in the terminal you can select text with the mouse,
copy and paste where you wish.

I use the XTERM terminal with this options from Gnome's menu:

xterm -bg yellow4 -fg white -title 'CDDOIT - CD Creation & Sound' -cr white -e cddoit


7.
Multisession data:
The data image files for multisession data are special. The first data image
to copy is different from the next data images. CDDOIT warning about this.
Be carefull.


8.
In multisession audio you must to close the CD-R after copy the last audio
track. Go menu AUDIO CD-R, option n 8.


9.
In audio conversions between diferent formats, the sound quality maybe not the
best. (See menu AUDIO, option n 10)

10.
Audio recording programs:
- Don't cover up programs at the same date/time. SOX no start until the previous
  SOX finish.

-------------------------------------------------------------------------------

This is free software.
Only, I would like to know in many countries of the world CDDOIT is being
used, for that reason would be thankful to you that you sent me a mail
(cddoit@yahoo.com) indicating only your country and city.
Thanks in advance.

I'm from Madrid, Spain.

Report bugs or suggestions to: cddoit@yahoo.com
This software comes with NO warranty of any kind. Use at your own risk.

Jose L. Diaz.

