Different options need different data-types as arguments:
bool can be "yes" or "no", like in --vbr=yesstring can be anything, like in --rename-fmt "%n.%t"
int an integer number, like in --bitrate192 (or --bitrate=192 )
list multiple strings, delimited by the final ";". Example: --guess-tocfile1.mp3file2.mp3...fileN.mp3 \;
Jack understands the following options:
--append-year=bool
if known, append the year to dir in the format " (%y)"
-b,--bitrateint
target bitrate (in kbit/s, default is 160).
--char-filterstring
convert file names using a python method
--charsetstring
charset of filenames (defaults to your locale).
-c,--check-toc
compare toc-file and cd-toc, then exit. Jack caches the TOC of a CD in a file ("jack.toc"). If you
want to know if the inserted CD matches the toc-file in the current directory, use this option.
-C,--claim-dir
rename directories even if they were was not created by Jack.
--cont-failed-query
continue without FreeDB data if query fails.
-D,--create-dirs
tells Jack to create sub-directories in which Jack puts all the files for the current CD. If no
FreeDB data is available, i.e. when not using -Q , these directories will be named "jack-
xxxxxxxx" where "xxxxxxxx" stands for the CD's FreeDB ID. Otherwise dir_template (see above) will
be used. This option is turned on by default.
--devicestring
The device-name of your cdrom-drive. The default is /dev/cdrom--dir-templatestring
if directories are renamed, this is the format used (default "%a/%l")
-d,--dont-work
don't do DAE, encoding, tagging or renaming. This may be useful if you only want to do a FreeDB
query, e.g. while another jack is running.
--edit-freedb
open an editor to change the CDDB information which has been obtained previously (only useful with
-Q).
--encoder-name,-Estring
use which encoder (default "oggenc")
-e,--encodersint
encode how many files in parallel. If you have a SMP machine or simply want to stress your system,
you can have Jack encode several files at once.
-x,--exec
run predefined command when finished.
--extt-is-artist
the artist is contained in the EXTT fields. The EXTT fields are lines in the FreeDB file which
contain additional data for each track. As it's the submitting user's choice what to use them for,
Jack can't determine by itself what they were intended for. You have to provide this information.
--extt-is-title
the track title is contained in the EXTT fields.
--extt-is-comment
a track comment is contained in the EXTT fields.
--force
do not ask. Like when deleting incomplete files.
-f,--from-tocfilestring
rip from a cdrdao created CD image on hd. The specified toc-file contains the name of the image
file. Use -F if jack can't find the image file.
-F,--from-imagestring
read audio data from image file. Like --from-tocfile, but the image itself is specified instead of
the tocfile. If you do not have a toc-file (or don't specify a toc-file), the TOC is read from the
CD itself.
-g,--guess-toclist
make up a TOC from the MP3 file given in mp3_files. Format is track_01.mp3...track_nn.mp3; Note
that the trailing " ; " is only necessary if you want to append more options to your command line.
You can use it to do a FreeDB query based on MP3s alone - no need for the CD. Very useful if you
have no idea which CD the MP3s are from. The MP3s must be given in the same order as they were on
their CD. The generated TOC file is similar, but not identical to the TOC of the CD - do not
submit these!
-G,--id3-genrestring
set ID3 genre. Use 'help' to get a list of all known genres. (You can also specify the ID3v1 genre
as an int)
-Y,--id3-yearint
set ID3 year.
-h,--help
Show summary of options.
-k,--keep-wavs
do not delete WAVs after encoding them.
-m,--mail-submit
submit FreeDB entry via e-mail. HTTP submission is preferred. You will have to enter the category
of the CD.
-l,--max-loadfloat
only start new encoders if your system's load is below the specified value. /proc/loadavg must be
readable by you for this to work.
--multi-mode
try to query FreeDB for all dirs in searchdirs which have no FreeDB data.
--my-mailstring
your e-mail address, needed for FreeDB submissions.
-n,--niceint
nice-level with which the encoders are started. Default is 12 which shouldn't hurt your system
much.
-o,--overwrite
overwrite existing files, i.e. do not check if already ripped WAVs or an already encoded file seem
to be OK. Use this if you know something went wrong last time. This is off by default.
-O,--only-dae
only produce WAVs, implies --keep-wavs. This is off by default.
--otf=bool
On-the-fly operation. Only on some encoders/rippers. Do not create WAVs, pipe ripper output
through the encoder. Default is no as it's a torture for the CDROM drive.
-o,--overwrite=bool
overwrite existing files.
--qualityint
vbr encoding quality. -1 is lowest, 10 highest (default 6). You can also specify a float.
-q,--query
do FreeDB query when all is done. This is useful if Jack was previously run without a FreeDB
query. If all tracks are done you don't even have to have a CD inserted as the TOC is cached by
Jack. After having finished ripping and encoding, Jack will rename the files and tag them.
--query-if-needed=bool
like --query-now, but only if FreeDB data hasn't been successfully queried before.
-Q,--query-now
do FreeDB query when starting. Use this if you are connected to the Internet when starting Jack.
Know that the query may need user-interaction. After having finished ripping and encoding, Jack
will rename the files and tag them.
-a,--read-aheadint
read how many WAVs in advance. At most read_ahead + num_encoders WAVs are ripped before a track
has completely been encoded. Default is 99 which will read the whole CD, provided there is enough
disk space.
--remove-files
have Jack remove its temp jack*-files. Be careful - don't delete them too early!
-R,--rename
rename and tag files according to FreeDB file. On startup, Jack creates a blank FreeDB entry file
(except if --query-now is used, then the file is queried from your FreeDB server). If you have
changed its contents (e.g. because the CD was unknown to FreeDB) and want to rename and tag your
MP3s accordingly, use this option. Give all other needed options too, like -t , -E , ...
--rename-dir=bool
rename directory as well (default).
--rename-fmtstring
format of normal files (default "%n - %t")
--rename-fmt-vastring
format of Various Artists files (default "%n - %a - %t")
--rename-numstring
format of the track number (%n, printf() style) used to rename the files (default "%02d")
-r,--reorder=bool
optimize track-order for disk space. This can save you some peak disk space during the encoding
process; this may make it possible to do a CD which would otherwise fail to be encoded.
--replacement-charslist
unusable chars are replaced by the corresponding list item (default "%").
--ripperstring
which program to use for extracting the audio data (default "cdparanoia").
--save save options to ~/.jack3rc file and exit.
--scan-dirsint
Scan this many levels from the current working directory for a matching toc-file (0 to disable,
default 2).
--searchlist
add these directories to the list of directories searched when looking for the workdir (default
".").
--serverstring
which FreeDB server to use. Don't forget to set your HTTP proxy. Currently either "freedb"
(default) or "freedb-de".
--silent-mode=bool
be quiet (no screen output).
-s,--spaceint
forcibly set usable disk space, in bytes. This option lets you limit the disk space Jack uses,
maybe you need it for something else? Be careful: if set too high or too low, ripping and encoding
will probably fail. The default is to look how much is free and to use this value.
--submit
submit FreeDB entry via HTTP. You will have to enter the category of the CD.
-S,--swab=bool
swap byte order from image file. As cdrdao momentarily only outputs "raw" .cdr files, you quite
likely want to swap the byte order. Try this option if your WAVs and encoded files contain only
noise. This is on by default as cdrdao currently generates .cdr files that are "wrong".
--todo print what would be done and exit.
-t,--tracksstring
limit ripping and encoding to the specified tracks, use comma to separate tracks. Ranges are also
possible; 5-9 is equivalent to 5,6,7,8,9; 12- is like specifying track 12,...,last_track. The
default is to process the whole CD.
-u,--undo-rename
undo file renaming and exit. If you don't like how Jack renamed your files, use this option to
restore the previous state. Several levels of undo are possible. Note that ID3 tags are not
restored.
--unusable-charslist
characters which can't be used in filenames (default "/").
--upd-progress
have Jack re-create its temp files. Use this if you deleted them too early.
--update-freedb,-U
update the FreeDB info and exit.
--usage-win=bool
show the help screen while running.
-v,--vbr=bool
Generate variable bitrate files, only on encoders which support this. Default is no.
--various=bool
when parsing FreeDB data, Jack assumes that if the disc´s artist is set to "Various" the track
titles have the format "[artist] - [title]". If the disc title is set to something else and you
still want the above behaviour, use --various.--various-swap
exchange artist and title, many FreeDB entries have them wrong.
--wait=bool
wait for key press before quitting.
-w,--workdirstring
where to create directories and put the files.
--write-id3v1=bool
write a smart id3v1 tag to the encoded file.
--write-id3v2=bool
write an id3v2 tag to the encoded file.
--write-m3u
create a playlist in .m3u format. This has bugs, don't rely on it.