Help/README

   1                         Ripper
   2                         A MP3/OGG ripper/encoder
   3                         by Ken Hayber
   4
   5 Brief
   6 ~~~~~
   7 GUI front-end to cdda2wav and lame to rip and encode CD music to mp3 or ogg
   8 The latest version of Ripper is at:
   9
  10         http://hayber.us/rox/Ripper
  11
  12
  13 Conditions
  14 ~~~~~~~~~~
  15 This program is free software; you can redistribute it and/or modify
  16 it under the terms of the GNU General Public License as published by
  17 the Free Software Foundation; either version 2 of the License, or
  18 (at your option) any later version.
  19
  20 This program is distributed in the hope that it will be useful,
  21 but WITHOUT ANY WARRANTY; without even the implied warranty of
  22 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  23 GNU General Public License for more details.
  24
  25 You should have received a copy of the GNU General Public License
  26 along with this program; if not, write to the Free Software
  27 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  28
  29 Please report any bugs to me, Ken Hayber <khayber@socal.rr.com>
  30
  31
  32 Instructions
  33 ~~~~~~~~~~~~
  34 Extract the tgz file and run the application.  Select the Preferences button and configure
  35 things for your system.  It is best if you are familiar with making cdda2wav and lame
  36 work from the command line.
  37
  38 The LUN value in Options|Ripper is the device that is actually used by cdda2wav for ripping.
  39 If you have an IDE/ATAPI cdrom drive you may need to use the 'ATAPI:' prefix.  Otherwise
  40 (e.g. you are using scsi or ide-scsi) just the normal lun specification should work.
  41
  42 Some options necessary to make cdda2wav and lame work with Ripper are hardcoded into the
  43 application.  Others may be added by the user.  See the cdda2wav and lame man pages.
  44
  45 The refresh button will re-query the cddb server and reload the cd information.  Currently,
  46 if there are multiple returns from cddb one is chosen at random, so repeated clicking of
  47 the refresh button is the only way to see the others (this will change).
  48
  49 Clicking the rip & encode button starts ripping and encoding as parallel threads.  The
  50 progress of each song is shown.  Ripping will almost always finish long before Encoding.
  51 Therefore you may eject the CD (there is an auto setting for this) and load another CD
  52 while the previous one is still encoding.  However the new CD will not be read until the
  53 encoding is done.
  54
  55 Double clicking on each song will let you edit the track name.  The track name is used
  56 in the id tag literally, but the output filename has certain characters replaced
  57 automatically.  (there may later be an option to edit this replacement list.  there may
  58 also later be an option to allow things like Year, Genre, Artist, etc. to be edited
  59 per song this way.)
  60
  61 Clicking the Stop button aborts both ripping and encoding and displays 'error' in the
  62 status area.
  63
  64 Each wav file is deleted after encoding, whether successful or not.
  65
  66
  67 Email the author for help :)