acxi options:

Page Updated: 2021-09-24
acxi version: 3.5.00

The following are the supported options of acxi. If your version of acxi is missing any of these options, update to the newest version, or file an issue report with your distro to have them update their acxi package.

acxi v: 3.4.01 :: Supported Options:
Examples: acxi -q 8 --destination /music/main/ogg
acxi --input flac --output ogg -a md5
acxi --copy doc,docx,bmp
-----------------------------------------------------------------
Syncing options:
--append, -a      Add extension type(s) to existing extension copy list.
                  1 or more, comma separated, no spaces.
--clean           Clean directories and files from destination not found in
                  source music directory. Will show you directories/files to
                  be deleted then ask you to confirm (twice) that you want to
                  remove that set of files or directories. Exits at end.
                  optional value 'sync' is used: --clean sync
--codec           {libfdk-aac|aac} - if you want to use alternate codec.
                  Output -o aac/m4a only
--copy, -c        List of alternate data types to copy to Output type
                  directories. Comma separated, no spaces. See sample above.
                  Current copy types: gif jpg jpeg png txt flac
--destination, -d Path to the directory where you want the processed
                  (eg, ogg) files to go.
                  Current value: /home/harald/mm/downloads/acxi-test
--exclude, -x     Exclude a list of unique strings separated by ^^. Excludes
                  sync/copy action to destination directory. Replaces
                  $EXCLUDE values if present. Anything matching in file path
                  will be excluded. Can also be path to a file of excludes.
                  Sample: --exclude='artwork^^Daisy Queen^^Bon Jovi'
                  Sample: --exclude='/home/me/music/excludes/acxi-exclude.txt
--exclude-append, -y
                  Append an item to the list of excludes or file.
                  Sample: --exclude-append='My Sharona^^Dancing Queen'
--ffmpeg          Force flac to ogg/opus conversions to use ffmpeg. Useful if
                  you want to include embedded images to oggs (Experimental).
--force, -f       Force overwrite the mp3/ogg/opus/jpg/txt/etc. files, even
                  if they already exist.
--fork, -F        [0-x] - Number of forks/threads to use. 0 default, disables.
                  Requires Perl module: Parallel::ForkManager. Current: 0
--input, -i       Input type: {aif,flac,raw,shn,wav}. shn requires codec
                  shorten. raw,shn only output to flac. Current value: flac
--output, -o      Output type: {aac, flac. m4a, mp3, ogg, opus. aac/m4a/mp3}
                  require input type flac. To preserve flac tags for aac, use
                  m4a. Current value: opus
--quality, -q {n} Qualities for output types:
                  flac: n between 0 and 8. 8 best, but > 4 generally pointless.
                  aac/m4a: n between 10 and 500. 500 best quality.
                  ogg: n between -1 and 10. Fractions ok. 10 best quality.
                  opus: n between 6-256. Variable bit rate. 256 best quality.
                  mp3: n between 0-9. Variable bit rate, 0 best quality.
                  Current values: 160 (aac/m4a); 3 (mp3); 
                  7 (ogg); 160 (opus)
--resample        {bit depth:sample rate khz} - Supports bit depth 16|20|24 and
                  sample rates 44.1|48|88.2|96|192. Read manual for more info.
                  Example --resample 16:48
--resample-override
                  Allows all supported flac resampling values: 2-32 bit depths;
                  1-655 khz sampling rates (decimals ok).
--source, -s      Path to the top-most directory containing your source files.
                  Current value: /home/harald/mm/downloads/music
--source-glob, -g {Path inside -s directory with wildcards}
                  Wildcard path, using *, paths relative to -s path.
                  Allows work on only a subset of directories in -s path.
-----------------------------------------------------------------
Specialized options (tagging, checksums, prefills, etc):
--aggregate, -G   [filename|extension] Copy file name or extension type to
                  --destination directory. If no argument given, copies over
                  auto.tag. Do not use . in extension (jpg good, .jpg bad)
                  You can supply more than one filename or extension:
                  (file name): acxi -d ~/music/cdinfo --aggregate info.txt
                  (extension): acxi -d ~/music/cdinfo --aggregate jpg
                  (several): acxi -d ~/music/cdinfo --aggregate png,jpg,info.txt
--analyze, -Z     Analyze contents of directories, creates screen report per
                  file/directory. Currently only supports flac. Shows total
                  time, size, ffp avg kbs, etc. Similar to -Xq but prints to
                  screen. -v2 adds ffp,changes to 1 key:value pair per line,
                  -v 3 adds precision.
--autotag, -A     Requires auto.tag formatted file in each directory. Flac only.
                  Deletes all existing tags, then creates a fully tagged set of
                  files.
--autotag-create, -C
                  Create auto.tag template in source directory. Will be
                  populated with file names for recording filled in already in
                  track listing. Preserves existing REPLAYGAIN values. Not
                  recommended, use -S or -M instead.
--autotag-create-multi, -M {disc ID}
                  Required argument tells logic how to determine your disc
                  numbering method. % is used to indicate the value is a number
                  between 1-9. @ is used to indicate a letter between A-Z. 
                  Will complete TRACKTOTAL, DISCNUMBER, TRACKNUMBER values
                  in auto.tag file, which saves a time. See -E for more prefill
                  options.
                  Samples: -M d% [d1track02.flac]; -M d%- [d2-track04.flac];
                  -M % [112.flac]; -M 2015-03-21.d%. [2015-03-21.d1.t03.flac]
                  -M @ [A12.flac]; -M d@- [da-track02.flac];
                  Flac input type only.
--autotag-create-single, -S
                  For single disc recordings, will also add TRACKTOTAL and
                  TRACKNUMBER counts when creating and populating the
                  auto.tag file. See -E for more prefill options.
--checksum, -K    Create .ffp and .md5 checksum files in your source directory.
                  Checksum files are only created inside directories where flac
                  files are found. Use --checksum-delete if you also want
                  to delete existing checksum files. Only flac type
                  is supported.
                  Do not use together with cleaning/syncing options!
--checksum-delete, -D
                  Delete all existing .ffp, .md5, .ffp.txt, and md5.txt files
                  before creating the new checksum files. Files only deleted in
                  directories where flac files are found.
--checksum-ffps, --ffps
                  Prints only ffps to screen, turns off md5 tests
--checksum-verify, -V
                  Verifies FLAC files and confirms MD5 file data matches actual
                  files found. Can be run alone or with --checksum options.
--dot             Also sync files and directories starting with a '.'. Don't
                  blame acxi if this creates unintended consequences!!
--duplicates, --dupes
                  Test a directory of many releases for duplicated ffp files.
--image, -I {jpg,png image file name|remove}
                  Embed image file into single recording directory. 'remove'
                  value only removes images.
--infofix, -X [dnqtuw]
                  Fix info.txt files. Use any combination. Always cleans white
                  space issues.
                  d: make iso date: YYYY-MM-DD from various random date formats
                  l: Set all lowercase, and apply simple upper case first fixes.
                  n: make track numbering 'NN. ' (0 padded) or 'N-NN. '
                  q: add FLAC/Quality: /[quality] items to info file
                  t: fix upper/lower case track titles
                  u: fix entire file upper/lower
                  w: write changes to file
                  t and u use Title upper case main words.
--info-rating {2-xxx}
                  Change default rating value for --infofix q. Current: 4;
--nlink           Set $File::Find::dont_use_nlink = 0. Expert use only.
--no-dot          Override user configuration setting for DOT (--dot) [default].
--no-ffp          Skips ffp processing on --checksum or --checksum-verify.
--no-md5          Skips md5 processing on --checksum or --checksum-verify.
--no-nlink        Set $File::Find::dont_use_nlink = 1 [default].
                  Expert use only.
--prefill, -E     Attempt to prefill auto.tag file using info.txt data. See man
                  for required syntax and structure of data in info file.
--prefill-file {file name}
                  Alternate file name to use for --prefill.
--no-replaygain   Does not preserve REPLAYGAIN values for autotag-create.
--recurse {0-xx}  Set directory recursion levels. Default infinite. Useful
                  for having syncing or checksum tools ignore sub directories.
--remove-images, -R
                  Remove all embedded images and image padding from file
                  before autotagging.
--remove-padding, -P
                  For --autotag and --tag also removes block padding. Slows.
                  tagging down significantly.
--start {0-xx}    For auto.tag, starts tag numbering of tracks at supplied
                  integer value. Useful if tracks start at 00.flac or 07.flac
--tag, -T         {"TAG1%:tag value^^TAG2%:tag value}
                  Updates one or more recordings with the supplied FLAC
                  tag/value pairs. Removes existing sets of the given type.
                  Use ^^ to separate tag key/value pairs, and %: to separate
                  the tag name and its value. Value 'UNSET' removes the tag.
--update, -U      Update acxi and man page. Set paths if not Linux.
                  Current values: acxi: /usr/local/bin
                  man acxi.1: /usr/local/share/man/man1
-----------------------------------------------------------------
Display output and debugging options:
--debug           Trigger advanced output debugging data.
--help, -h        This help menu.
--quiet           Turns off most screen output, except for error messages.
                  Only disables screen output is logical to do so. Same as -v 0
--test            Test copy, sync, autotag, checksum without actually doing
                  the action.
--version         Show acxi version.
--verbosity, -v   {0-3} Dynamically set VERBOSITY. Current value: 1
                  0: Turns off all output, except for error messages.
                  1: Basic single line per operation output, default value.
                  2: Without full verbosity of -v3, no flac/lame/oggenc/opusenc
                  for conversion process screen output.
                  3: Full output, including full verbosity of ffmpeg/flac/
                  lame/oggenc/opusenc conversion process for aac, m4a, mp3, ogg,
                  or opus output.
-----------------------------------------------------------------
User Configs (checked in this order):
/etc/acxi.conf
$XDG_CONFIG_HOME/acxi.conf
$HOME/.config/acxi.conf
$HOME/.acxi.conf
Requires this syntax (any user modifiable variable can be used)
SOURCE_DIRECTORY=/home/me/music/flac
DESTINATION_DIRECTORY=/home/me/music/opus
Do not use $, ", or ' in config options or values (except in path names).

top