# @(#)README    1.0.5 20/03/2014 Copyright 2003-2014 Robert M. Stockmann
#

This is version 1.0.5 of the MP3 Rip-Kit.

The MP3 Rip-Kit is a Makefile and a bunch of shell/awk/sed scripts with
the purpose to convert your AUDIO CD's into MP3 files using a single
command. You will need besides these scripts also the following
programs to be installed on your Linux machine :

############################################################################
#
# REQUIRED SOFTWARE :

1. CDDA2WAV		
  cdda2wav is a one of the programs inside the cdrtools from Joerg Schilling. 
  Normally your Linux PC should it already have installed. If not you can 
  download the original source from :

	ftp://ftp.berlios.de/pub/schily/cdrtools

2. LAME
  lame is the mp3 encoder used. if its not already installed on your linux PC,
  then you can download it from :

	http://lame.sourceforge.net/

3. CDRDAO
  cdrdao is also a on-the-fly rip/burn tool, but it has the nice feature that 
  it can do a read-cddb query from the CDDB databases online on the Internet. 
  cdrdao also comes mostly with your distribution so no problem. 
  The download site is on :

	http://cdrdao.sourceforge.net/

############################################################################
#
# REQUIRED PATCH FOR CDRDAO :

However most cdrdao version's won't be able to connect to a cddb database
server out of the box. You will need to apply a very small patch to get
the read-cddb command going :

edit ./dao/main.cc and look for the following line :

  if (cddb.connectDb(user, host, "cdrdao", VERSION) != 0) {

and change it into :

  if (cddb.connectDb(user, host, "xmcd", "2.6") != 0) {

recompile your cdrdao version, and then you can proceed to start ripping
and computing mp3's which automaticly include the official CDDB track info
as the mp3 file names. Inside the several RPMS directory's for cdrdao
you also find adjusted SRPMS. Make sure that your version of cdrdao
is configured with the following option :

  --with-scglib           use bundled libscg SCSI library (see INSTALL) 
				(default is NO)

############################################################################
#
# SHORT INSTRUCTIONS :

1. untar the package in a directory where your want to rip/compute the mp3's.

	tar xvzf mp3-ripkit-1.0.5.tar.gz

2. Edit the Makefile and adjust the basename BASE = green to that of the 
   artist/album, and adjust the device name of your AUDIO CDROM READER 
   DEVICE = 1,3,0. a good to tool check which device you need to use is 

	cdrecord -scanbus

   Also check http://crashrecovery.org/oss-dvd/HOWTO-ossdvd.html on how
   to scan/check your available AUDIO CDROM READER devices. Lately cdrecord
   and its tools are changing to ATA driven IO. Currently the best way is to
   check for devices with cdrecord is 

	cdrecord dev=ATA -scanbus

   resulting in :

Cdrecord-Clone 2.01a32 (i686-pc-linux-gnu) Copyright (C) 1995-2004 Jörg Schillin
g
NOTE: this is OSS DVD extensions for cdrtools and thus may have bugs
   related to DVD issues that are not present in the original cdrtools. For
   more information see http://crashrecovery.org/oss-dvd.html. The original
   cdrtools author should not be bothered with problems in this version.
scsidev: 'ATA'
devname: 'ATA'
scsibus: -2 target: -2 lun: -2
Warning: Using badly designed ATAPI via /dev/hd* interface.
Linux sg driver version: 3.5.27
Using libscg version 'schily-0.8'.
cdrecord: Warning: using inofficial libscg transport code version (warly-Mandrakelinux-scsi-linux-sg '@(#)scsi-linux-sg.c       1.83 04/05/20 Copyright 1997 J. Schilling').

scsibus0:
        0,0,0     0) *
        0,1,0     1) 'Compaq  ' 'DVD-ROM SD-C2402' '1A05' Removable CD-ROM
        0,2,0     2) *
        0,3,0     3) *
        0,4,0     4) *
        0,5,0     5) *
        0,6,0     6) *
        0,7,0     7) *

   So inside the Makefile the above scanning result is added as 
   DEVICE=ATA:0,1,0

3. well after the Makefile is edited you can just run this :

	./runit.sh

4. when cdrdao can't find a matching cddb database record for your audio
   CD-ROM, then you should go back to the drawing board. Instead of running
   ./runit.sh , one should at the first instance only run the two first
   steps from ./runit.sh :

	make
	make toc

  next manually edit your toc file green.toc and green.tocfile and 
  insert the correct album TITLE, album PERFORMER, track TITLE(s) and
  track PERFORMER(s) . Make sure green.toc and green.tocfile are the same.
  next run the last four steps from ./runit.sh :

	make doit
	make -j 4 mp3s
	make rename
	make distclean

 5. wait and listen! Enyoy :)

Robert M. Stockmann
<stock@stokkie.net>
Thu Mar 20 19:59:59 CET 2014