README for crip - last updated:  Fri Apr  4 00:59:37 CST 2003
-------------------------------------------------------------------------------

INSTALL INSTRUCTIONS:
---------------------

This should help get you started:


You will need the following software installed first:

Linux, perl, cdparanoia, oggenc (Ogg Vorbis encoder), vorbiscomment
(from vorbistools), vorbisgain (if you have normalization turned off
as recommended), and sox (v12.17.0).  Or,  if you chose to encode
with the FLAC encoder,  you will need flac and its tools.

Sorry about all the prerequisites,  but you should have all these on
your Linux system anyway,  especially if you're going to be making
good, professional-quality music files.
You must have sox version 12.17.0.  Versions later than this use a
different scheme for trimming that doesn't seem to work properly yet
in the latest version of sox (12.17.3).

First,  copy the CDDB_get.pm file somewhere where your perl will look
for its .pm files like so:

cp CDDB_get.pm /usr/lib/perl5/site_perl/

Next you will want to copy over the files crip, wav_find_beginning
and wav_find_end somewhere in your path.  Note that crip calls
wav_find_beginning and wav_find_end,  which are binaries created by the
.c programs also found in this directory.  So if the binaries don't work
on your system you may need to recompile them like this:

gcc -O2 wav_find_end.c -o wav_find_end

Note that the script will cut out the zeros from the beginning/end
of the wav file and not necessarily the silence.  So if you want to trim
more silence out of your MP3 then you'll have to do it manually.  But it
has always worked satisfactorily for me.

Look at the first few variables in the crip script file and make sure that
they are set the way you want them to be.  Note that I use '-q 4' as the
oggenc flags that I use to encode,  which encodes to about 128kbps Ogg
Vorbis.  If you don't like it change it!



USAGE INSTRUCTIONS:
-------------------

Just `cd` to a directory on a robust drive with plenty of space.  There
will be a lot of hard drive activity so make sure the drive is good and
can handle it without overheating or otherwise failing.  Then run crip
from the directory where you want the .wav files and .ogg / .flac files
to go.  crip assumes that your CDROM device is /dev/cdrom.

When finished just move off the music files to where you want them to go
and 'rm *' everything left in that directory.

That's it!  You now have very good "professional-grade" and properly
labeled Ogg Vorbis (or FLAC) files of your music.


For a tutorial of how to answer the questions once you run the script,
plus documentation for the script, see:

http://bach.dynet.com/crip/tutorial-2.5.html

(I know I need to make a new tutorial).



Charlton
charlton@dynet.com

