BeRip v0.7 Beta
---------------

This application offers a nice GUI interface to ripping and encoding
audio tracks from CDs.

Tracks to encode can be selected by left (or right) clicking on them on the
"Track Selection" tab.  Left clicking exclusively selects the track, while
Ctrl-left clicking or right clicking toggles the track (and leaves the other
tracks selected).  Shift-left clicking is also present, but works a bit odd
at this time (selects tracks towards the table top until it encounters the
first track or a previously selected track).

The Options tab allows you to set storage preferences.  If you include the
track number in the filename, you can start numbering the tracks as desired
using the text control.  This is useful if you want to combine multi-disc
albums in one directory, and still maintain ordering.

Ripping the tracks to Microsoft WAV or Raw format is as simple as selecting the
desired tracks on the "Track Selection" tab, and clicking the Begin button
on the "Rip Tracks" tab.

Currently, ripping to MP3 via the BladeEnc add-on uses 44.1kHz at 160kbps.
Future releases of the add-on will have this configurable via the Options
tab.

*** New in 0.7 ***

* An installer was added (install.sh) to the distribution, since add-ons
  now exist (BladeEncoder, RawEncoder, and WaveEncoder) that need to be
  moved to a sepecific directory (~/config/add-ons/BeRip/).

* MP3 support is now available via the included BladeEnc encoder.  This uses
  the standard 0.82 Blade enoding software, with a BeOS add-on wrapper.

* The user can now abort the ripping and encoding of CDs.

* Widgets are properly disabled (grayed out) while ripping is in progress.

* When actually reading the CD, the program ups its priority to Real-Time,
  to minimize read errors.  When the block has been read (before encoding
  begins), the priority is returned to normal.  Also, before reading a block
  in earnest, BeRip reads 5 seconds worth of audio in order to bring the
  CD up to speed (also reduces read errors).

* CDDB information, once found on the server, is saved locally.

* Preferences on the Options tab, as well as which encoder to use, are now
  saved and retrieved properly.

*** Notes ***

I haven't YET figured out a good way to locate a CD-ROM drive under BeOS,
so the software currently looks at the master device on IDE1 (a pretty standard
location for ATAPI drives).  If this isn't how your computer is configured,
BeRip won't work for you.  (I still wonder how DriveSetup identifies all the
drives, darn it.)

*** Warnings ***

Since this software is still in the Alpha release state, it is far from
perfect.  One major note: don't begin ripping CDs on the "Rip Tracks" tab
and attempt to switch tabs while the process is ongoing.  Due to what I
believe is a BeOS bug, this causes the application to crash.  For some
reason, disabling the tabs doesn't seem to work either.

Make sure that if you enter a value into a Text Control on the Options tab,
you press enter to have the new value take affect.  Due to a different BeOS
bug, changing tabs without doing this causes the control to NOT inform the
application that its contents have changed.  (If Be doesn't fix this bug in
the near future, I can recode the software to work around this, but I'd rather
have it work as advertised =).

CDDB (CD Database) support is present, but a little limited.  The interface
I have written does not handle the CDDB server returning multiple results for
a query (yet).  This happens when some CDs have multiple entries in the
database.  While this doesn't occur often, it will prevent you from using
CDDB to identify that particular CD.

*** Future Plans ***

The CDDB interface class needs to be expanded to properly query the main
CDDB server (cddb.cddb.com) for server locations, and query the user as to
which one to use (currently us.cddb.com is hardcoded).  The interface also
needs to query the user for their email address, used to say hello to the
CDDB server.  And finally, the CDDB interface needs to query the user as to
which database entry to use when inexact/duplicate matches are encountered.

The TableView class (seen on the "Track Selection" tab) needs to have the
ability to add a scrollbar, in case you have a CD with a LOT of tracks.

John Whitney
jwhitney@sands-edge.com
