tooLAME - an optimized mpeg 1/2 layer 2 audio encoder

Contents

• LGPL
• Introduction
• Usage
• Examples
• Contributors
• References

LGPL

All changes to the ISO source are licensed under the LGPL  
(see LGPL.txt for details)

tooLAME is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

tooLAME is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with tooLAME; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Introduction

• the ISO dist10 code
• improvement to algorithms as part of the LAME project (www.sulaco.org/mp3)
• work by myself and other contributors (see CONTRIBUTORS)

Installation

1. edit Makefile (at least change the architecture type [ARCH] to suit your machine)
2. 'make'

Usage

         ./toolame [options] [input file] [output file]

Input File
	tooLAME parses AIFF and WAV files for file info
	raw PCM is assumed if no header is found
	for stdin use a -

Output File
	file is automatically renamed from *.* to *.mp2
	for stdout use a -

Input Options
	-s [int]
		if inputting raw PCM sound, you must specify the sample rate
		default sample rate is 44.1khz.

	-a	
		downmix from stereo to mono
		if the incoming file is stereo, combine the audio into 
		a single channel

	-x 	
		force byte-swapping of the input.  (current endian detection is dodgy, 
		so if toolame produces only noise, use -x )

	-g
		swap the LR channels of a stereo file

Output Options
	-m [char]
		the encoding mode (default 'j')
		's' stereo
		'd' dual channel
		'j' joint stereo
		'm' mono

	-p [int]
		which psy model to use (default '1')
		Different models for the psychoacoustics
	        Models: -1 to 4

	-b [int]
		the total bitrate 	
		For 48/44.1/32kHz default = 192 
		For 24/22.05/16kHz default = 96

	-v [int]
		Switch on VBR mode.
		The higher the number the better the quality.
		Useful range -10 to 10.
		See README.VBR for details.
		
		
Operation
	-f 	
		fast mode turns off calculation of the psychoacoustic model.
		Instead a set of default values are assumed

	-q [int]
		quick mode calculates the psy model every 'num' frames.

Misc
	-d emp
		de-emphasis (default 'n')
	-c 	
		mark as copyright
	-o
		mark as original
	-e
		add error protection
	-r
		force padding bits off
	-D
		add DAB extensions
	-t [int]
		'talkativity' setting. 0 = no message. 3 = too much information
                (-t 20 will probably flood you off your terminal)

Examples

	toolame sound.wav

	toolame -p 2 -v 5 sound.wav newfile.mp2

	toolame -p 2 -v -5 sound.wav newfile.mp2

	cat sound.raw | toolame -s 22050 -f -b 96 - newfile.mp2

Contributors

• Dist10 code writers
• LAME specific contributions
  • fht routines from Ron Mayer mayer at acuson.com
  • fht tweaking by Mathew Hendry math at vissci.com
  • window_subband & filter_subband from LAME circa v3.30 (multiple LAME authors) (before Takehiro's window/filter/mdct combination)
• Oliver Lietz - lietz at nanocosmos.de - Tables included in the exe
• Patrick de Smet - pds at telin.rug.ac.be - scale_factor calc speedup. subband_quantization speedup
• Federico Grau - grauf at rfa.org - and Bill Eldridge - bill at hk.rfa.org - option for "no padding"
• Nick Burch - gagravarr at SoftHome.net - WAV file reading, os/2 Makefile mods.
• Phillipe Jouguet - philippe.jouguet at vdldiffusion.com - DAB extensions. spelling, LSF using psyII, WAVE reading [02j]
• Henrik Herranen - leopold at vlsi.fi - fixed WAVE reading [02j]
• Andreas Neukoetter - anti at webhome.de - verbosity patch '-t' switch for transcode plugin [02j]
• Sami Sallinen - sami.sallinen at g-cluster.com - filter_subband loop unroll, psycho_i fix for "% 1408" calcs [02j]
• Ricardo Schelp - ricardoschelp at arnet.com.ar - merged window/filter subband for a nice speedup [02k]
• Nicolas Croiset - ncroiset at vdl.fr - DAB length control, ignore 4GB limit when reading from stdin, fixed bitstream ending to allow concatenation of mp2 files, fixes for psycho1 model [02k]
• Mike Cheng mikecheng at NOT planckenergy.com - Most of the rest

References