acxi options:

Page Updated: 2021-06-08
acxi version: 3.3.28

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.3.28 :: 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] -o aac/m4a only, if you want to use
                  alternate codec.
--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/me/music/opus
--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, -X
                  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 n, -q n 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); 144 (opus)
--source, -s      Path to the top-most directory containing your source files.
                  Current value: /home/me/music/flac
-----------------------------------------------------------------
Specialized options:
--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
--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-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!!
--image, -I [jpg,png image file name|remove]
                  Embed image file into single recording directory. 'remove'
                  value only removes images.
--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-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:
--basic           Basic single line per operation screen output, default value.
                  Same as --log 1
--full            Full screen output, including full verbosity of 
                  flac/lame/oggenc/opusenc conversion process for mp3, ogg,
                  or opus output. Same as --log 3
--debug           Trigger advanced output debugging data. Same as --log 4
--help, -h        This help menu.
--log             [0-4] Dynamically set LOG_LEVEL. Current value: 1
--quiet           Turns off all screen output, except for error messages.
                  Same as --log 0
--test            Test copy, sync, autotag, checksum without actually doing 
                  the action. Also activates --full for more verbose outputs.
--verbose         Without full verbosity of full, no flac/lame/oggenc/opusenc
                  for conversion process screen output. More verbose than
                  --basic. Same as --log 2
--version, -v     Show acxi version.
-----------------------------------------------------------------
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/ogg
Do not use $, ", or ' in config options or values (except in path names).


top