NAME¶
pacpl - Perl Audio Converter, a multi purpose converter/ripper/tagger
SYNOPSIS¶
pacpl --to <format> <options> [file(s)/directory(s)]
DESCRIPTION¶
Perl Audio Converter is a tool for converting multiple audio types from one
format to another. It supports AAC, AC3, AIFF, APE, AU, AVR, BONK, CAF, CDR,
FAP, FLA, FLAC, IRCAM, LA, LPAC, MAT, MAT4, MAT5, M4A, MMF, MP2, MP3, MP4,
MPC, MPP, NIST, OFR, OFS, OGG, PAC, PAF, PVF, RA, RAM, RAW, SD2, SF, SHN, SMP,
SND, SPX, TTA, VOC, W64, WAV, WMA, and WV. It can also convert audio from the
following video extensions: RM, RV, ASF, DivX, MPG, MKV, MPEG, AVI, MOV, OGM,
QT, VCD, SVCD, M4V, NSV, NUV, PSP, SMK, VOB, FLV, and WMV. A CD ripping
function with CDDB support, batch conversion, tag preservation for most
supported formats, independent tag reading/writing, and extensions for Amarok,
Dolphin, and Konqueror are also provided.
OPTIONS¶
-t, --to format
set encode format for the input file(s) or directory(s). you can see a complete
list of supported encode formats by using the
--formats option.
-r, --recursive
recursively scan and convert input folder(s) to desination format.
-p, --preserve
when recursively converting a directory, preserve the input folders directory
structure in the specified output directory. such as:
pacpl --to ogg -r -p /home/mp3s --outdir /home/oggs
in the example above, let's assume the directory structure was:
- /home/mp3s/Alternative
- /home/mp3s/Alternative/New
- /home/mp3s/Rap
- /home/mp3s/Country
- /home/mp3s/Techno/
the output directory will now contain:
- /home/oggs/Alternative
- /home/oggs/Alternative/New
- /home/oggs/Rap
- /home/oggs/Country
- /home/oggs/Techno
with all files in each sub-folder converted to ogg.
-o, --only format
only convert files matching extenstion. this option is useful when you have a
directory or batch of files with mixed audio types and only need to convert
one specific type.
-k, --keep
do not re-encode files with extensions matching the destination extension.
instead...copy them to the output folder, or skip to the next file.
- -f, --formats show a list of supported encode/decode
formats.
- -h, --help show the short help menu.
- -l, --longhelp display the complete list of
options.
- --version show version and licensing
information.
USER OPTIONS¶
--defopts 1/0
to turn off default encoder options use --defopts 0. this option gives you more
control when using the --eopts command.
defopts is set to 1 by default. you can also toggle this option in
/etc/pacpl/pacpl.conf.
--eopts options
this option allows you to use encoder options not implemented by pacpl. an
example would be:
pacpl --to mp4 --eopts="-c 44100 -I 1,2" YourFile.mp3
--dopts options
this option allows you to use decoder options not implemented by pacpl. an
example would be:
pacpl --to mpc --dopts="--start 60" YourFile.ogg
--outfile name
set the output file name to
name.
--outdir directory
place all encoded files in
directory.
--dryrun
show what would be done without actually converting anything. this is a good way
to trouble shoot, or to see what would be done without actually touching your
files.
--overwrite
replace the output file if it already exists.
--normalize
adjusts volume levels of audio files.
--nopts options
this allows you to specify normalize options not implemented by pacpl
--delete
remove source/input file after the conversion process has finished.
--encoder encoder
specify an alternate encoder for the selected output file(s)
you can see a list of supported encoders by using the following:
pacpl --encoder
format
--decoder decoder
specify an alternate decoder for the selected input file(s)
you can see a list of supported decoders by using the following:
pacpl --decoder
format
-v, --verbose
show detailed information about the encoding process and what's actually being
done.
ENCODER OPTIONS¶
--bitrate num
set the bitrate to
num. default is 128. this option does not apply to all
formats.
--freq num
set the frequency to
num. default is 44100. this option does not apply to
all formats.
--channels num
set the number of audio channels in the output file to
num. this option
does not apply to all formats.
--effect str
see
sox(1). this option only applies to the following:
AIFF, AU, SND, RAW, VOC, SMP, AVR, and CDR
--fcomp num
set flac compression level to
num. fastest -0, highest -8, default -2
--pcomp num
set lpac/pac compression level to
num.
- 1 = fast
- 2 = simple
- 3 = medium (default)
- 4 = high
- 5 = extra high,
--acomp num
set ape compression level to
num.
- 1000 = fast
- 2000 = normal
- 3000 = high (default)
- 4000 = extra high
- 5000 = insane
--oggqual num
set ogg quality level to
num. -1, very low and 10 very high, default 3
--spxqual num
set speex quality level to
num. 0-10, default 8
--aacqual num
set aac, mp4, m4a, or m4b quality level to
num. default 300
--mpcqual str
set mpc/mpp quality level to
str.
- thumb low quality/internet, (typ. 58... 86 kbps)
- radio medium (MP3) quality, (typ. 112...152 kbps -
default)
- standard high quality (dflt), (typ. 142...184 kbps)
- xtreme extreme high quality, (typ. 168...212 kbps)
--ofmode str
set ofr/ofs compression mode to
str. normal, extra, and extranew modes
are recommended for general use. available options are:
- fast
- normal (default)
- high
- extra
- best
- highnew
- extranew
- bestnew
--ofopt str
set ofr/ofs optimization level to
str.
specify the optimization level in the engine. In order to achieve optimal
compression at all sample types, sample rates, and audio content, the core
compression engine has the possibility to find the optimal values for its
parameters, at the cost of slightly increased compression time only. The
default recommended value is fast. do not use normal (or even high or best)
for this parameter unless encoding time does not matter and you want to obtain
the smallest possible file for a given compression mode. The difference
between the optimize levels fast and best (which is up to three times slower
than fast) is very small, generally under 0.05%, but may be also larger in
some rare cases. Note that the none optimize level is forced by the encoder to
fast optimize level for the extra, best, highnew, extranew, and bestnew modes.
available options are:
- none
- fast (default)
- normal
- high
- best
--bratio num
set bonk down sampling ratio. default 2
--bquanl num
set bonk quantanization level. default 1.0
--bpsize num
set bonk predictor size. default 128
TAGGING OPTIONS¶
note:
tagging outside of the encoding process can only be performed on the following
audio types:
- MP3
- OGG
- FLA
- FLAC
--artist str
set artist information to
str.
--title str
set title information to
str.
--track num
set track information to
num.
--year num
set year/date information to
num.
--album str
set album information to
str.
--genre str
set genre information to
str.
--comment str
set comment information to
str.
--taginfo file
show tagging information for
file. multiple files can be specified at
once.
RIPPING OPTIONS¶
--rip num/all
rip selected tracks separated by comma or all from current disc.
- pacpl --rip all --to flac
- pacpl --rip 1,3,9,15 --to flac
--nocddb
disable cddb. use this option if you do not want tagging based on cddb.
--noinput
disable cddb interactivity. this is enabled by default.
--nscheme str
set naming scheme to
str. default is %ar - %ti
available options are:
- %ar = artist
- %ti = song title
- %tr = track
- %yr = year
- %ab = album
eg: --nscheme="(%tr)-%ti"
--device str
set device to
str. default is /dev/cdrom
--cdinfo
show cddb information for current disc.
SEE ALSO¶
- sox(1) ffmpeg(1) lame(1)
oggenc(1) oggdec(1)
- flac(1) shorten(1) faac(1)
faad(1) mppenc(1)
- mppdec(1) mplayer(1) speexenc(1)
speexdec(1)
- sndfile-convert(1) normalize(1)
cdparanoia(1)
BUGS¶
Report all bugs to Philip Lyons (viiron@gmail.com).
LICENSING¶
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 3 of the License, or (at your option) any later
version.
This program 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 General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program. If not, see <
http://www.gnu.org/licenses/>.
AUTHOR¶
Copyright (C) 2005-2009 Philip Lyons (viiron@gmail.com)