Perl Audio Converter - Philip Lyons (viiron@gmail.com)

Usage
=====

pacpl --<formattoformat> <--file/--dir> <file(s)/dir(s)>

pacpl --convertto <format> <--file/--dir> <file(s)/dir(s)>

Use 'pacpl --help' or 'pacpl --man' for a list of options.


Requirements  
============

* = Required   

-----------     -------     ----
Application     Version     Link
-----------     -------     ----

*perl            5.8.7     http://www.perl.com

lame            3.96.1     http://lame.sourceforge.net
flac             1.2.1     http://flac.sourceforge.net
mac               3.99     http://www.sourceforge.net/projects/mac-port
shorten          3.5.1     http://www.etree.org/linux.html#reqsoft
faac              1.24+    http://www.audiocoding.com
faad               2.0     http://www.audiocoding.com
cdparanoia         9.8     http://www.xiph.org/paranoia
oggenc           1.0.1     http://www.vorbis.com
oggdec             1.0     http://www.vorbis.com
mplayer        1.0pre7+    http://www.mplayerhq.hu
mppenc            1.15     http://www.musepack.com
mppdec          1.95z2     http://www.musepack.com
wavpack          4.3.2     http://www.wavpack.com
ofr/ofs          4.510     http://www.LosslessAudio.org
ttaenc             3.2     http://www.true-audio.com
lpac              1.40     http://www.nue.tu-berlin.de/wer/liebchen/lpac.html
kexis            0.2.2     http://sourceforge.net/projects/kexis
ffmpeg           0.4.9     http://ffmpeg.sourceforge.net
la                0.3d     http://www.lossless-audio.com
bonk               0.6     http://www.logarithmic.net/pfh/bonk
sox            12.17.8     http://sox.sourceforge.net/

amarok             1.3     http://amarok.kde.org


Required Perl Modules
=====================

*Getopt::Long        
*File::Find
*File::Copy
*File::Basename
*Parse::RecDescent
*Carp
*Inline
*Inline::C
*Pod::Usage

Tag Modules
===========

To install all modules below type the following:

pacpl-install --install tags

Or you can install them manually by doing the following:

MP3::Tag            -   perl -MCPAN -e 'install MP3::Info'
MP4::Info           -   perl -MCPAN -e 'install MP4::Info'
Ogg::Vorbis::Header -   perl -MCPAN -e 'install Ogg::Vorbis::Header'
Audio::WMA          -   perl -MCPAN -e 'install Audio::WMA'
Audio::FLAC::Header -   perl -MCPAN -e 'install Audio::FLAC::Header'
Audio::Musepack     -   perl -MCPAN -e 'install Audio::Musepack'
Audio::APETags      -   perl -MCPAN -e 'install Audio::Musepack'
CDDB_get            -   perl -MCPAN -e 'install CDDB_get'


Background
==========

PAC is an attempt to create an "all-in-one" audio converter 
front-end. I've seen many audio converters that will convert
mp3->ogg, ogg->mp3, etc. for linux, but never one that would 
convert from *most* popular formats to the another.

PAC also includes extensions for converting your audio files
in KDE through amaroK and Konqueror.


Examples
========

Most operations should be fairly easy.  Converting an entire mp3 
directory to ogg is as simple as...

pacpl --mp3toogg --dir=/home/user/mp3s

or if you need to convert several different mp3s to wav format
and put them in your home directory to burn a CD you would simply...

pacpl --mp3towav --outdir=/home/jondoe --file=file1.mp3 --file=file2.mp3 


Recursive Directory Encoding
============================

pacpl --wavtomp3 --dir=/home/my_wav_files/ --recursive
pacpl --convertto ape --dir=/home/dir/ --recursive


Regular Expressions
===================

pacpl --mp3toflac *.mp3
pacpl --mp3toogg  Creed*


Playlist
========

Convert files in playlist.  Supported formats are (XMMS & PATH/FILE)

Playlists should be in the following format

/path/to/Song.ogg
/path/to/Song2.ogg

XMMS .M3U format is also supported

pacpl --oggtomp3  --playlist myplaylist
pacpl --flactotta --playlist xmms.m3u


KDE Examples
============

Konqueror
*********
Open Konqueror and browse to your audio directory.  Right click on an
audio file/directory, left click on Actions, left click on PAC Convert
and choose the audio format you wish to convert to.

To disable any of the warnings/popups/dialogs edit pac.conf
and change the undesired action to 0

Bugs
====

If you encounter a bug, please email me a detailed description
of the problem at (viiron@gmail.com) and it will be corrected 
in the next release, or a patch will be submitted.

As always, bug reports are needed and greatly appreciated.

Feature Request
===============

Notice something missing?
Have a feature you would like implemented?
Audio codec you need not found?
Questions / Comments?



Email: Philip Lyons (viiron@gmail.com)



Jobs
====

Translation           -  Any language(s) other than English would 
                         be appreciated.  If your interested shoot me an
                         email, and you will be provided with certain
                         text to be translated.

Beta Testers         

Distribution Packages -  As of now, other than the Slackware package that I
                         provide there is a package for Debian (thanks to 
                         Chad Martin).  I would like to add as many more as 
                         possible.
