.\" Process this file
.\" groff -man -Tascii tear.1
.\"
.TH TEAR 1 "Updated: JANUARY 2001" Linux "MP3 Creation"
.SH NAME
.B tear
\- a front-end for common MP3 tools
.SH SYNOPSIS
.B tear [-options] [--long_options]
.SH DESCRIPTION
.B tear
is a program designed to allow an entire CD to be encoded into
high-quality MP3s.

.B tear
is a front-end written in perl.
.B tear
queries a CDDB server for
information about the CD, or the user may type the required information
manually. After everything is known, the CD is ripped into WAV files
by
.BR cdparanoia
or
.BR cdda2wav.
The WAV files are then encoded using 
.BR lame,
.BR bladeenc,
.BR gogo,
.BR xing,
or
.BR mp3enc
into MP3s. The MP3s are then named and tagged according to the CDDB 
results using
.BR id3tool.

When invoked from the command line with no options,
.B tear
will rip and
encode the CD located in
.IR /dev/cdrom "."
It will use
.BR cdparanoia,
.BR lame,
us.cddb.org, and
.BR id3tool
to complete this.
.SH Custom File Naming
The MP3 and WAV files can be custom configured. The settings to do this
can be done from the command line or the configuration file. It is also
possible to customize the directory structure using similar settings.

The user can also specify the files/directories to include the following
options.
.IP "%a = Artist"
.IP "%t = Disc Title"
.IP "%s = Track Name"
.IP "%n = Track Number"
.IP "%g = Disc Category"
.SH Multiple Step Tearing
Upon request
.B tear
can be set to use multiple steps to complete the MP3 creation process. The first step is to rip the entire CD into WAV files. The second step is to encode the saved WAV files into MP3s.

This option can only be called from the command line interface. Add --step (1 or 2) depending on which step you wish to follow at the time. The CDDB will be queried during both steps, in the future we hope to eliminate the need for this.
.SH Nice Levels
.B Tear
now includes support for 
.B nice,
which allows the CD Ripper and the MP3 Encoder to be run with an "adjusted scheduling priority."
The priority setting is modified in conjunction to a number ranging from -20 to 19. -20 represents the highest priority and 19 representing the lowest priority. 0 is the default and lets
.B tear
run as if 
.B nice
was not an influence.

The nice levels can be configured through the command-line or from within the configuration files.
.SH OPTIONS
This program follows the usual  GNU  command  line  syntax, with long 
options starting with two dashes (`-').  A complete list of options are
included below.  For another description, use the help option.
.IP --verbose,\ -n
Verbose Mode
.IP --noconf
Skip All Configuration Files
.IP --step,\ -s
Tear CD in multiple steps.

( 1 = Step 1, 2 = Step 2 )
.IP --batch,\ -b
Batch rip from CD
.IP --nobatch
Don't batch rip (Default)
.IP --noerror
Disable creation of MP3 checksums
.IP --munge
Munge file names (replace " " with _'s)
.IP --ripper
Change CD Ripper

( 0 = SKIP, 1 =
.B CDPARANOIA
, 2 =
.B CDDA2WAV
)
.IP --mp3name,\ --wavname
Set MP3 or WAV file name using template
.IP --track,\ -t\ NUMBER
Only tear track #NUMBER
.IP --wav,\ -w
Save WAV files in
.B SAVEDIR/wavs
.IP --nowav
Delete WAV files after encoded (Default)
.IP --noid3
Don't make ID3 tags
.IP --cddb
Double-Check CDDB results
.IP --nocddb
Enter CDDB information manually
.IP --encoder,\ -e\ NUMBER
Change Encoder

( 0 = SKIP, 1 = 
.B LAME
, 2 = 
.B BLADEENC
, 3 =
.B GOGO
, 4 =
.B XING
, 5 =
.B MP3ENC
)
.IP --bitrate,\ -r\ NUMBER
Change MP3 bitrate (kb/s)

(32 40 48 56 64 80 96 112 128 160 192 224 <256> 320)
.IP --nice
Set Nice Level (-20 -- 19)
.IP --ripnice
Set Nice Level (-20 -- 19) on Ripper
.IP --encnice
Set Nice Level (-20 -- 19) on Encoder
.IP "--mp3dir /foo/bar"
Save MP3 files in
.I "/foo/bar"
.IP "--wavdir bar/foo"
Save WAV files in
.I "bar/foo"
.IP --version,\ -v
Display tear version number
.IP --help,\ -h
Display tear help
.SH Configuration Files
.B tear
includes support for configuration files. These files must be
.IR "/etc/tearrc" ", " "~/.tearrc" ", or " "./.tearrc" "."
All of the supported variables are listed below. If you do not wish to
change the default value you do not have to include that variable in the
file. Changing the version information may result in an error.

VARIABLE : VALUE (NO parenthesis):
.IP "VERBOSE : (Yes,No)"
.IP "RIPPER : (cdparanoia,cdda2wav)"
.IP "CDBATCH : (Yes,No)"
.IP "SAVEWAV : (Yes,No)"
.IP "CDDEV : (CD-Rom\ Device)"
.IP "MP3ENC : (lame,bladeenc,gogo,xing,mp3enc)"
.IP "MP3BIT : (32,40,48,56,64,80,96,112,128,160,192,224,<256>,320)"
.IP "ID3COM : (Your\ Comment\ in\ the\ ID3s)"
.IP "CDDBUSE : (Yes,Check,No)"
.IP "MP3DIR : /foo/bar"
.IP "WAVDIR : bar/foo"
.IP "MP3NAME : %a - %n.mp3"
.IP "WAVNAME : %a - %n.wav"
.IP "NICE : (-20 -- 19)"
.IP "RIPNICE : (-20 -- 19)"
.IP "ENCNICE : (-20 -- 19)"
.SH EXAMPLES
If there are any features listed here that you do not understand or need, then you probably will not have to change the features default setting.

A few examples:

tear only track number 14 using bladeenc while double checking the CDDB results 
.RS
tear --cddb -t 14 -e 1

.RE
tear the entire CD @ 128 kb/s using bladeenc
.RS
tear -wb 128 -e 1

.RE
tear the entire CD quietly @ 256 kb/s using lame
.RS
tear
.SH AUTHOR
.B tear
and this manual page were written by Gregory Reynolds

<DevDuck@users.sourceforge.net>
.SH "SEE ALSO"
.BR cdparanoia (1),
.BR cdda2wav (1),
.BR CDDB_get (3),
.BR id3tool (1),
.BR nice (1)
