.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "PACPL 1"
.TH PACPL 1 "2023-02-01" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
pacpl \- Perl Audio Converter, a multi purpose converter/ripper/tagger
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
pacpl \-\-to <format> <options> [file(s)/directory(s)]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Perl Audio Converter
.PP
A Linux \s-1CLI\s0 tool for converting multiple audio types from one format to another.
.PP
It supports the following audio formats:
.PP
========================================
.PP
3G2, 3GP, 8SVX, \s-1AAC, AC3, ADTS, AIFF, AL, AMB, AMR, APE, AU,\s0 
\&\s-1AVR, BONK, CAF, CDR, CVU, DAT, DSF, DTS, DVMS, F32, F64, FAP, FLA,\s0 
\&\s-1FLAC, FSSD, GSRT, HCOM, IMA, IRCAM, LA, MAT, MAUD, MAT4, MAT5,\s0 
M4A, \s-1MP2, MP3, MP4, MPC, MPP, NIST, OFF, OFR, OFS, OPUS, OGA,\s0 
\&\s-1OGG, PAF, PRC, PVF, RA, RAM, RAW, RF64, SD2, SF, SHN, SMP, SND,\s0 
\&\s-1SOU, SPX, SRN, TAK, TTA, TXW, VOC, VMS, VQF, W64, WAV, WMA,\s0 
and \s-1WV.\s0
.PP
It can also extract audio from the following video extensions:
.PP
==============================================================
.PP
\&\s-1RM, RV, ASF,\s0 DivX, \s-1MPG, MKV, MPEG, AVI, MOV, OGM, OGV, QT, VCD,\s0 
\&\s-1SVCD, M4V, NSV, NUV, PSP, SMK, VOB, FLV, WEBM\s0 and \s-1WMV.\s0
.PP
Parallel Processing, a \s-1CD\s0 ripping function with \s-1CDDB\s0 support, batch conversion, 
tag preservation for most supported formats, independent tag reading & writing, 
service menus for \s-1KDE\s0 Dolphin/Konqueror, \s-1GNOME\s0 Nautilus script, and action 
scripts for Nemo/Thunar are also provided.
.SH "OPTIONS"
.IX Header "OPTIONS"
\&\fB\-t, \-\-to\fR \fIformat\fR
.PP
set encode format for the input file(s) or directory(ies).  you can see a
complete list of supported encode formats by using the \fB\-\-formats\fR option.
.PP
\&\fB\-r, \-\-recursive\fR
.PP
recursively scan and convert input folder(s) to destination format.
.PP
\&\fB\-p, \-\-preserve\fR
.PP
when recursively converting a directory, preserve the input folders directory 
structure in the specified output directory.  such as:
.PP
pacpl \-\-to ogg \-r \-p /home/mp3s \-\-outdir /home/oggs
.PP
in the example above, let's assume the directory structure was:
.IP "/home/mp3s/Alternative" 21
.IX Item "/home/mp3s/Alternative"
.PD 0
.IP "/home/mp3s/Alternative/New" 21
.IX Item "/home/mp3s/Alternative/New"
.IP "/home/mp3s/Rap" 21
.IX Item "/home/mp3s/Rap"
.IP "/home/mp3s/Country" 21
.IX Item "/home/mp3s/Country"
.IP "/home/mp3s/Techno/" 21
.IX Item "/home/mp3s/Techno/"
.PD
.PP
the output directory will now contain:
.IP "/home/oggs/Alternative" 4
.IX Item "/home/oggs/Alternative"
.PD 0
.IP "/home/oggs/Alternative/New" 4
.IX Item "/home/oggs/Alternative/New"
.IP "/home/oggs/Rap" 4
.IX Item "/home/oggs/Rap"
.IP "/home/oggs/Country" 4
.IX Item "/home/oggs/Country"
.IP "/home/oggs/Techno" 4
.IX Item "/home/oggs/Techno"
.PD
.PP
with all files in each sub-folder converted to ogg.
.PP
\&\fB\-o, \-\-only\fR \fIformat\fR
.PP
only convert files matching extension.  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.
.PP
\&\fB\-k, \-\-keep\fR
.PP
do not re-encode files with extensions matching the destination extension.  
instead...copy them to the output folder, or skip to the next file.
.PP
\&\fB\-j, \-\-jobs\fR
.PP
number of simultanious jobs to run at once.  the default limit
is set to 4 in pacpl.conf.  You can modify this value on the fly 
using \-\-jobs=<num> or set it perminately in the configuration file
.IP "\fB\-f, \-\-formats\fR    show a list of supported encode/decode formats." 4
.IX Item "-f, --formats show a list of supported encode/decode formats."
.PD 0
.IP "\fB\-h, \-\-help\fR       show the short help menu." 4
.IX Item "-h, --help show the short help menu."
.IP "\fB\-l, \-\-longhelp\fR   display the complete list of options." 4
.IX Item "-l, --longhelp display the complete list of options."
.IP "\fB\-\-version\fR        show version and licensing information." 4
.IX Item "--version show version and licensing information."
.PD
.SH "USER OPTIONS"
.IX Header "USER OPTIONS"
\&\fB\-\-defopts\fR \fI1/0\fR
.PP
to turn off default encoder options use \-\-defopts 0. this option gives you 
more control when using the \-\-eopts command.
.PP
defopts is set to 1 by default.  you can also toggle this option in
/etc/pacpl/pacpl.conf.
.PP
\&\fB\-\-eopts\fR \fIoptions\fR
.PP
this option allows you to use encoder options not implemented by pacpl.
an example would be:
.PP
pacpl \-\-to mp4 \-\-eopts=\*(L"\-c 44100 \-I 1,2\*(R" YourFile.mp3
.PP
\&\fB\-\-dopts\fR \fIoptions\fR
.PP
this option allows you to use decoder options not implemented by pacpl.
an example would be:
.PP
pacpl \-\-to mpc \-\-dopts=\*(L"\-\-start 60\*(R" YourFile.ogg
.PP
\&\fB\-\-outfile\fR \fIname\fR
.PP
set the output file name to \fIname\fR.
.PP
\&\fB\-\-outdir\fR \fIdirectory\fR
.PP
place all encoded files in \fIdirectory\fR.
.PP
\&\fB\-\-dryrun\fR
.PP
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.
.PP
\&\fB\-\-overwrite\fR
.PP
replace the output file if it already exists.
.PP
\&\fB\-\-normalize\fR
.PP
adjusts volume levels of audio files.
.PP
\&\fB\-\-nopts\fR \fIoptions\fR
.PP
this allows you to specify normalize options not implemented by pacpl
.PP
\&\fB\-\-delete\fR
.PP
remove source/input file after the conversion process has finished.
.PP
\&\fB\-\-encoder\fR \fIencoder\fR
.PP
specify an alternate encoder for the selected output file(s)
.PP
you can see a list of supported encoders by using the following:
.PP
pacpl \-\-encoder \fIformat\fR
.PP
\&\fB\-\-decoder\fR \fIdecoder\fR
.PP
specify an alternate decoder for the selected input file(s)
.PP
you can see a list of supported decoders by using the following:
.PP
pacpl \-\-decoder \fIformat\fR
.PP
\&\fB\-v, \-\-verbose\fR
.PP
show detailed information about the encoding process and what's actually
being done.
.SH "ENCODER OPTIONS"
.IX Header "ENCODER OPTIONS"
\&\fB\-\-bitrate\fR \fInum\fR
.PP
set the bitrate to \fInum\fR.  default is 128.  this option does not apply 
to all formats.
.PP
\&\fB\-\-freq\fR \fInum\fR
.PP
set the frequency to \fInum\fR.  default is 44100.  this option does not apply
to all formats.
.PP
\&\fB\-\-channels\fR \fInum\fR
.PP
set the number of audio channels in the output file to \fInum\fR.  this option
does not apply to all formats.
.PP
\&\fB\-\-effect\fR \fIstr\fR
.PP
see \fBsox\fR(1).  this option only applies to the following:
.PP
\&\s-1AIFF, AU, SND, RAW, VOC, SMP, AVR,\s0 and \s-1CDR\s0
.PP
\&\fB\-\-fcomp\fR \fInum\fR
.PP
set flac compression level to \fInum\fR. fastest \-0, highest \-8, default \-2
.IP "1 = fast" 4
.IX Item "1 = fast"
.PD 0
.IP "2 = simple" 4
.IX Item "2 = simple"
.IP "3 = medium (default)" 4
.IX Item "3 = medium (default)"
.IP "4 = high" 4
.IX Item "4 = high"
.IP "5 = extra high," 4
.IX Item "5 = extra high,"
.PD
.PP
\&\fB\-\-acomp\fR \fInum\fR
.PP
set ape compression level to \fInum\fR.
.IP "1000 = fast" 4
.IX Item "1000 = fast"
.PD 0
.IP "2000 = normal" 4
.IX Item "2000 = normal"
.IP "3000 = high (default)" 4
.IX Item "3000 = high (default)"
.IP "4000 = extra high" 4
.IX Item "4000 = extra high"
.IP "5000 = insane" 4
.IX Item "5000 = insane"
.PD
.PP
\&\fB\-\-oggqual\fR \fInum\fR
.PP
set ogg quality level to \fInum\fR. \-1, very low and 10 very high, default 3
.PP
\&\fB\-\-spxqual\fR \fInum\fR
.PP
set speex quality level to \fInum\fR. 0\-10, default 8 (use \-\-bitrate <num> when using ffmpeg/avconv as encoder)
.PP
\&\fB\-\-aacqual\fR \fInum\fR
.PP
set aac, mp4, m4a, or m4b quality level to \fInum\fR. default 300
.PP
\&\fB\-\-mpcqual\fR \fIstr\fR
.PP
set mpc/mpp quality level to \fIstr\fR.
.IP "thumb        low quality/internet, (typ.  58... 86 kbps)" 4
.IX Item "thumb low quality/internet, (typ. 58... 86 kbps)"
.PD 0
.IP "radio        medium (\s-1MP3\s0) quality, (typ. 112...152 kbps \- default)" 4
.IX Item "radio medium (MP3) quality, (typ. 112...152 kbps - default)"
.IP "standard     high quality (dflt),  (typ. 142...184 kbps)" 4
.IX Item "standard high quality (dflt), (typ. 142...184 kbps)"
.IP "xtreme       extreme high quality, (typ. 168...212 kbps)" 4
.IX Item "xtreme extreme high quality, (typ. 168...212 kbps)"
.PD
.PP
\&\fB\-\-ofmode\fR \fIstr\fR
.PP
set off/ofr/ofs compression mode to \fIstr\fR.  normal, extra, and extranew modes
are recommended for general use.  available options are:
.IP "fast" 4
.IX Item "fast"
.PD 0
.IP "normal (default)" 4
.IX Item "normal (default)"
.IP "high" 4
.IX Item "high"
.IP "extra" 4
.IX Item "extra"
.IP "best" 4
.IX Item "best"
.IP "highnew" 4
.IX Item "highnew"
.IP "extranew" 4
.IX Item "extranew"
.IP "bestnew" 4
.IX Item "bestnew"
.PD
.PP
\&\fB\-\-ofopt\fR \fIstr\fR
.PP
set off/ofr/ofs optimization level to \fIstr\fR.
.PP
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.
.PP
available options are:
.IP "none" 4
.IX Item "none"
.PD 0
.IP "fast (default)" 4
.IX Item "fast (default)"
.IP "normal" 4
.IX Item "normal"
.IP "high" 4
.IX Item "high"
.IP "best" 4
.IX Item "best"
.PD
.PP
\&\fB\-\-bratio\fR \fInum\fR
.PP
set bonk down sampling ratio.  default 2
.PP
\&\fB\-\-bquanl\fR \fInum\fR
.PP
set bonk quantanization level.  default 1.0
.PP
\&\fB\-\-bpsize\fR \fInum\fR
.PP
set bonk predictor size.  default 128
.SH "TAGGING OPTIONS"
.IX Header "TAGGING OPTIONS"
\&\fBnote:\fR
.PP
tagging outside of the encoding process can only be performed on the
following audio types:
.IP "\s-1MP3\s0" 4
.IX Item "MP3"
.PD 0
.IP "\s-1OGG\s0" 4
.IX Item "OGG"
.IP "\s-1FLA\s0" 4
.IX Item "FLA"
.IP "\s-1FLAC\s0" 4
.IX Item "FLAC"
.PD
.PP
\&\fB\-\-artist\fR \fIstr\fR
.PP
set artist information to \fIstr\fR.
.PP
\&\fB\-\-title\fR \fIstr\fR
.PP
set title information to \fIstr\fR.
.PP
\&\fB\-\-track\fR \fInum\fR
.PP
set track information to \fInum\fR.
.PP
\&\fB\-\-year\fR \fInum\fR
.PP
set year/date information to \fInum\fR.
.PP
\&\fB\-\-album\fR \fIstr\fR
.PP
set album information to \fIstr\fR.
.PP
\&\fB\-\-genre\fR \fIstr\fR
.PP
set genre information to \fIstr\fR.
.PP
\&\fB\-\-comment\fR \fIstr\fR
.PP
set comment information to \fIstr\fR.
.PP
\&\fB\-\-taginfo\fR \fIfile\fR
.PP
show tagging information for \fIfile\fR.  multiple files can be specified
at once.
.SH "RIPPING OPTIONS"
.IX Header "RIPPING OPTIONS"
\&\fB\-\-rip\fR \fInum/all\fR
.PP
rip selected tracks separated by comma or all from current disc.
.IP "pacpl \-\-rip all \-\-to flac" 4
.IX Item "pacpl --rip all --to flac"
.PD 0
.IP "pacpl \-\-rip 1,3,9,15 \-\-to flac" 4
.IX Item "pacpl --rip 1,3,9,15 --to flac"
.PD
.PP
\&\fB\-\-nocddb\fR
.PP
disable cddb.  use this option if you do not want tagging based on cddb.
.PP
\&\fB\-\-noinput\fR
.PP
disable cddb interactivity.  this is enabled by default.
.PP
\&\fB\-\-nscheme\fR \fIstr\fR
.PP
set naming scheme to \fIstr\fR.  default is \f(CW%ar\fR \- \f(CW%ti\fR
.PP
available options are:
.ie n .IP "%ar = artist" 4
.el .IP "\f(CW%ar\fR = artist" 4
.IX Item "%ar = artist"
.PD 0
.ie n .IP "%ti = song title" 4
.el .IP "\f(CW%ti\fR = song title" 4
.IX Item "%ti = song title"
.ie n .IP "%tr = track" 4
.el .IP "\f(CW%tr\fR = track" 4
.IX Item "%tr = track"
.ie n .IP "%yr = year" 4
.el .IP "\f(CW%yr\fR = year" 4
.IX Item "%yr = year"
.ie n .IP "%ab = album" 4
.el .IP "\f(CW%ab\fR = album" 4
.IX Item "%ab = album"
.PD
.PP
\&\fBeg:\fR \-\-nscheme=\*(L"(%tr)\-%ti\*(R"
.PP
\&\fB\-\-device\fR \fIdevice\fR
.PP
set device to \fIdevice\fR.  default is /dev/dvd
.PP
\&\fB\-\-cdinfo\fR
.PP
show cddb information for current disc.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.IP "\fBsox\fR(1) \fBffmpeg\fR(1) \fBlame\fR(1) \fBoggenc\fR(1) \fBoggdec\fR(1)" 4
.IX Item "sox(1) ffmpeg(1) lame(1) oggenc(1) oggdec(1)"
.PD 0
.IP "\fBflac\fR(1) \fBshorten\fR(1) \fBfaac\fR(1) \fBfaad\fR(1) \fBmpcenc\fR(1)" 4
.IX Item "flac(1) shorten(1) faac(1) faad(1) mpcenc(1)"
.IP "\fBmpcdec\fR(1) \fBmplayer\fR(1) \fBspeexenc\fR(1) \fBspeexdec\fR(1)" 4
.IX Item "mpcdec(1) mplayer(1) speexenc(1) speexdec(1)"
.IP "\fBsndfile-convert\fR(1) \fBnormalize\fR(1) \fBcdparanoia\fR(1)" 4
.IX Item "sndfile-convert(1) normalize(1) cdparanoia(1)"
.IP "\fBopusenc\fR(1) \fBopusdec\fR(1) \fBwavpack\fR(1) \fBffmpeg\fR(1)" 4
.IX Item "opusenc(1) opusdec(1) wavpack(1) ffmpeg(1)"
.IP "\fBmplayer\fR(1) \fBavconv\fR(1)" 4
.IX Item "mplayer(1) avconv(1)"
.PD
.SH "BUGS"
.IX Header "BUGS"
Report all bugs to Philip Lyons (vorzox@gmail.com)
.SH "LICENSING"
.IX Header "LICENSING"
This program is free software; you can redistribute it and/or modify
it under the terms of the \s-1GNU\s0 General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0  See the
\&\s-1GNU\s0 General Public License for more details.
.PP
You should have received a copy of the \s-1GNU\s0 General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
.SH "AUTHOR"
.IX Header "AUTHOR"
<<<<<<< \s-1HEAD\s0
Copyright (C) 2005\-2021 Philip Lyons (vorzox@gmail.com)
=======
Copyright (C) 2005\-2019 Philip Lyons (vorzox@gmail.com)
>>>>>>> cc4eb189828ef15228da02c14a39e484294126ec