VLORB(1)

NAME
vlorb - a high quality Audio CD to audio file encoder

SYNOPSIS
vlorb [ -f ] [ -g ] [ -h ] [ -o ] [ -O ] [ -p ] [ -Q ] [ -r ] [ -s ] [ -S ] [ -t ] [ -V ] [ -d device ] [ -e encoder ] [ -i tracklist ] [ -m mask ] [ -M mask ]

DESCRIPTION

vlorb is a console frontend for cdparanoia and CDDB. It rips and encodes tracks from an audio CD to audio files. The aim of vlorb is to create high-quality audio files in a simple way, while providing a comfortable feature set.

vlorb uses CDDB to get CD information for tagging and file naming.

OPTIONS

-f  Toggle on-the-fly mode When enabled, vlorb will pipe the cdparanoia output through the specified encoder, which in effect means it'll encode at the same time it rips. On fast machines, this will be faster, on slow machines it'll be slower, so on slow machines you might want to disable it.

-g  Generate configuration file This will print your current configuration to STDOUT in a format readable by vlorb. You can save it by redirecting to /etc/vlorbrc or $HOME/.vlorbrc and adjust it to taste.

-h  Output help information and exit.

-o  Toggle ``overwrite tracks'' mode. By default, vlorb will not overwrite existing files. It will generate new filenames by adding ``.n'', where n is a number, between the filename and it's extension (.ogg). So, in case ``overwrite tracks'' mode is disabled, and if Elvis Presley - Love Me Tender.ogg exists, the new filename will be Elvis Presley - Love Me Tender.1.ogg. If that file also already exists, the new filename will become Elvis Presley - Love Me Tender.2.ogg, and so on, and so on.

-O  Toggle ``overwrite album dir'' mode. By default, vlorb will not overwrite album directories. It will generate new directory names by adding ``.n'' where n is a number. So, in case ``overwrite dir'' mode is disabled, and if the dir Metal Mania exists, the new album dir name will be Metal Mania.1. If that dir also already exists, the new album dir name will become Metal Mania.2, and so on, and so on. Enable ``overwrite album dir'' mode to disable this behaviour.

-p  Toggle ``show progress'' mode. When enabled, show oggenc encoding progress. It's ugly, but what the heck...

-Q  Toggle ``quiet'' mode. Only output error messages.

-r  Toggle ``ReplayGain'' mode. From the ReplayGain website: Not all CDs sound equally loud. The perceived loudness of mp3s is even more variable. Whilst different musical moods require that some tracks should sound louder than others, the loudness of a given CD has more to do with the year of issue or the whim of the producer than the intended emotional effect. If we add to this chaos the inconsistent quality of mp3 encoding, it's no wonder that a random play Through your music collection can have you leaping for the volume control every other track. There is a remarkably simple solution to this annoyance, and that is to store the required replay gain for each track within the track. This concept is called ``MetaData'', data about data. It's already possible to store the title, artist, and CD track number within an mp3 file using the ID3 standard. The later ID3v2 standard also incorporates the ability to store a track relative volume adjustment, which can be used to ``fix'' quiet or loud sounding mp3s. VorbisGain uses the ReplayGain algorithm to do the same thing to Ogg Vorbis audio files. Or, From the VorbisGain website: VorbisGain is a utility that uses a psychoacoustic method to correct the volume of an Ogg Vorbis file to a predefined stan- dardized loudness. For Ogg Vorbis encoding, this requires that vorbisgain(1) is in your path. FLAC has replaygain support built-in. More information:

    •   VorbisGain <URL:http://www.sjeng.org>

    •   ReplayGain <URL:http://www.replaygain.org>

-s  Toggle ``single-artist'' mode. By default, vlorb tries to detect if a CD is single-artist or multi-artist. In the rare case where it chooses wrongly, use this option to toggle single-artist mode.

-S  Optimize for speed rather than quality. By default, vlorb encodes optimized for quality; by enabling this option vlorb will optimize for speed, producing lower quality audio files

-t  Swap artist and tracktitle info Sometimes, CDDB has bad info, ie artist is set to the tracktitle, and tracktitle to artist. This swaps them so they're set correctly anyway.

-V  Show version

-d device
    Use the specified CD-ROM device

-e encoder
    Either ``oggenc'' to create Ogg Vorbis files, ``flac'' to create FLAC files or ``wav'' to create WAV files.

-i tracklist
    Only rip these tracks tracklist is in the form of '1,2,6,9'

-m mask
    Generate filenames using the specified mask, eg ``vlorb -m ADNT''

-M mask
    Generate album directories using this mask, eg ``vlorb -M DA''

FILES

•   /etc/vlorbrc system-wide configuration file

•   $HOME/.vlorbrc user configuration file

Format: key=value, comments start with ``#'' as the first character on a line.

  VLORB CONFIGURATION FILE
#
# vlorb configuration file
#   format: key=value
#
ogg_quality=3
cddb_host=freedb.freedb.org
overwrite_dir=1
overwrite_tracks=0

You can generate these files by using vlorb's ``-g'' option (see USAGE below)

Available configuration file options:

•   cddb_host Which host to use for CDDB connections

Example: cddb_host=freedb.freedb.org

•   cddb_port Which TCP/IP port to use for connection.

Example: cddb_port=8880

•   devices Comma seperated list of paths to device names of CD-ROM devices to use.

Example: devices=/dev/cdroms/cdrom0, /dev/cdroms/cdrom1

•   dirmask_s A = Artist, D = Disctitle Order of tags to use for directory name generation for single- artist CD's.

Example: dirmask_s=AD

•   encoder Default encoder to use, either ``oggenc'', ``flac'' or ``wav''

Example: encoder=flac

•   filemask_m A = Artist, D = Disctitle, G = Genre, N = Tracknumber, T = Tracktitle. Order of tags to use for filename generation for multi-artist CD's.

Example: filemask_m=DNAT

•   filemask_s A = Artist, D = Disctitle, G = Genre, N = Tracknumber, T = Tracktitle. Order of tags to use for filename generation for single-artist CD's.

Example: filemask_s=ADNT

•   filemask_seperator Seperator to use between parts of filename.

Example: filemask_seperator= -

•   ogg_bitrate Set default ogg encoding bitrate to the specified number.

Example: ogg_bitrate=128

•   ogg_bitrate_speed Set default ogg encoding bitrate when encoding optimized for speed to the specified number.

Example: ogg_bitrate_speed=48

•   ogg_quality Set default ogg encoding quality to the specified number, between -1 and 10.

Example: ogg_quality=6

•   ogg_quality_speed Set default ogg encoding quality to the specified number, between -1 and 10 when encoding optimized for speed.

Example: ogg_quality_speed=1

•   ogg_use_bitrate 1 = use bitrate, 0 = use quality.

Example: ogg_use_bitrate=0

•   on_the_fly 1 = encode on the fly, 0 = don't encode on the fly (create WAV files, and then encode those into encoded files)

Example: on_the_fly=1

•   optimize_speed 1 = optimize for speed rather than quality, 0 = optimize for quality rather than speed

Example: optimize_speed=0

•   overwrite_dir 1 = Overwrite album directory, 0 = generate non-existing album directory.

Example: overwrite_dir=0

•   overwrite_tracks 1 = Overwrite track files, 0 = generate non-existing track files.

Example: overwrite_tracks=0

•   quiet 1 = Show only error messages, 0 = show all output.

Example: quiet=0

•   remove_source_files When encoding off the fly: 1 = remove source files, 0 = keep source files

Example: remove_source_files=1

•   replaygain 1 = use ReplayGain to fix volumes, 0 = don't use ReplayGain

Example: replaygain=1

•   show_progress 1 = show oggenc encoding progress, 0 = don't show oggenc encoding progress.

Example: show_progress=1

•   stop_if_unknown 1 = stop if no cddb data is found, 0 = continue of no cddb data is found

Example: stop_if_unknown=1

•   unknown Name for CD's of which no CDDB data exists.

Example: unknown=Unknown Album

USAGE

To run this program the default way:

vlorb

To use /dev/cdroms/cdrom1 as device, and enable VorbisGain:

vlorb -d /dev/cdroms/cdrom1 -v

To only rip track numbers 3, 7 and 8:

vlorb -i '3,7,8'

To generate an initial configuration file in your home directory:

vlorb -g >~/.vlorbrc

To generate an initial configuration file in your home directory with ``VorbisGain'' mode toggled:

vlorb -v -g >~/.vlorbrc

To view the current configuration:

vlorb -g

BUGS

Please report them to <j.kossen@home.nl>

SEE ALSO

cdparanoia(1) oggenc(1) perl(1) vorbisgain(1)

AUTHORS

Jochem Kossen, <j.kossen@home.nl>