acxi options:

Page Updated: 2019-08-14
acxi version: 3.3.14

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.14 :: 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 extenssion 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.
--copy, -c        List of alternate data types to copy to Output type
                  directories. Comma separated, no spaces. See sample above.
                  Current copy types: 
                  bmp doc docx gif jpg jpeg odt pdf png tif txt flac
--destination, -d Path to the directory where you want the processed
                  (eg, ogg) files to go.
                  Current value: /home/you/music/ogg
--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: flac, wav, raw, shn. shn requires codec shorten. 
                  raw, shn only output to flac.
                  Current value: flac
--output, -o      Output type: mp3, ogg, opus. mp3 requires input type flac.
                  Current value: ogg
--quality n, -q n 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: 3 (mp3); 7 (ogg); 144 (opus)
--source, -s      Path to the top-most directory containing your source files.
                  Current value: /home/you/music/flac
-----------------------------------------------------------------
Specialized options:
--aggregate, -G   Copy all existing auto.tag files to the --destination
                  directory.With extra argument 'file' will create a single
                  filename using the source directory name plus the tag
                  file name.
--alt-ag [file]   Use with --aggregate if you want to collect different file
                  names in one location from your collection.
                  Sample: acxi -d ~/music/cdinfo --aggregate --alt-ag 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.
--autotag-create-multi, -M [disc ID]
                  Required argument tells logic how to determine your disc
                  numbering method. The % is used to indicate the value
                  is a number between 1-9. Will complete TRACKTOTAL, DISCNUMBER,
                  TRACKNUMBER values in auto.tag file, which saves a time.
                  Samples: -M d% [d1track02.flac]; -M d%- [d2-track04.flac];
                  -m % [112.flac]-M 2015-03-21.d%. [2015-03-21.d1.track03.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.
--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 other 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.
--nlink           Set $File::Find::dont_use_nlink = 0. Expert use only.
--no-nlink        Set $File::Find::dont_use_nlink = 1 [default].
                  Expert use only.
--no-replaygain   Does not preserve REPLAYGAIN values for autotag-create.
--remove-images   Remove all embedded images and image padding from file
                  before autotagging.
--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