RipEnc Quick Start / Installation

Most of this only has to be done the first time you run RipEnc.

Because RipEnc is a "front-end" script, it relies on other tools to do some its work. However, almost everything you need is included in this distribution, and should have been installed by the RipEnc installer. For legal reasons, however, you'll need to download and install a command-line MP3 encoder separately.

  1. I recommend putting either or both the GoGo or LAME encoders in ~/config/bin (if you don't do this, RipEnc will offer to download an encoder for you). Here are direct links, for reference:

    GoGo binary
    GoGo source
    LAME binary
    LAME source
    bladeenc binary
    Vorbis tools (to create .OGG rather than .MP3 files)

  2. Insert an audio CD and mount it by right-clicking on the Desktop and choosing "Audio CD" from the Mount menu. Once mounted, wait for its name to change to the name of the album -- This means the CD has been looked up in a compact disc database.

  3. Double-click the RipEnc launcher icon on the desktop.

  4. Use the Setup options to get configured. At the very least, press S to enter Setup and then D to detect your CD-ROM drive. Back at the main menu, press P to save your settings.
See the Usage page if necessary.

Note: The RipEnc installer made sure you have appropriate Audio indexes on your installation volume's filesystem so you can run MP3 queries later. However, if you have multiple BFS volumes on your system, you'll want to index each one you intend to store MP3s on. If this applies to you, see the readme in the Optional Scripts folder.

You're good to go.


Notes on cddblinkd

cddblinkd is a daemon that runs in the background and detects when you've inserted an audio CD, then looks it up in an online compact disc database so you get accurate artist, album, and track names. The RipEnc installer installed a version of cddblinkd in ~/config/bin and added it to your UserBootscript if necessary.

If you find that a lot of your audio CDs aren't being looked up properly, read the tip:

cdda-fs: Guarantee successful lookups

cddblinkd is a BeOS sample application, the original source to which is available at ftp://ftp.be.com/pub/samples/network_kit/cddblinkd.zip.

See cddblinkd.license in the docs folder for distribution permissions.