xcfa_cli(1)

📦 version 5.0.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 xcfa_cli 💖 — bestie edition

okay so this is xcfa_cli(1), from Manual version 0.0.6, and it's literally the command-line glow-up of xcfa. pull up a chair, we're doing this. 🫶

✨ NAME ✨

xcfa_cli — this program is an implementation of xcfa in command line. yes she's headless, yes she still ate. 💅

🌸 DESCRIPTION 🌸

xcfa_cli is an application for conversion, normalization, reconfiguring wav files and cut audio files ... like, all of it. she does the whole routine.

What xcfa_cli can do, in no particular order but very much in her main character era:

  • replaygain on files: flac, mp3, ogg, wavpack
  • conversions:
    • from files:
      • wav, flac, ape, wavpack, ogg, m4a, mpc, mp3, wma, shorten, rm, dts, aif, ac3
    • to files:
      • wav, flac, ape, wavpack, ogg, m4a, mpc, mp3, aac
    • conversion settings for file management:
      • flac, ape, wavpack, ogg, m4a, aac, mpc, mp3
  • management tags
  • management cue wav file
  • manipulation of the frequency, track and bit wav files
  • standardization on files: wav, mp3, ogg
  • cuts (split) wav files
  • displaying information on files

she's booked, busy and thriving. 👑

🦋 SYNOPSIS 🦋

xcfa_cli [ -i "file.*" ][ -d wav,mpc,... ][ OPTIONS ]

💜 OPTIONS 💜

  • --verbose — Verbose mode. she tells you everything, unprompted, like a true bestie. 💬
  • -h, --help — Print help mode and quit.
  • -i <"file.type">, --input <"file.type"> — Input name file to convert, in inverted commas, like --input "*.flac". Type input files: wav, flac, ape, wavpack, ogg, m4a, mpc, mp3, wma, shorten, rm, dts, aif, ac3
  • -o <path_dest/>, --output <path_dest/> — Destination folder. By default in the source file folder.
  • -d <wav,flac,ape,...>, --dest <wav,flac,ape,...> — Destination file: wav, flac, ape, wavpack, ogg, m4a, mpc, mp3, aac
  • -r, --recursion — Recursive search. she goes deep. 🔎
  • -e, --ext2src — Extract in the source folder. This option is useful with '--recursion'
  • --nice <priority> — Change the priority of running processes in the interval: 0 .. 20

🎀 Management options with default parameters 🎀

  • --op_flac — the default is "-5"
  • --op_ape — the default is "c2000"
  • --op_wavpack — the default is "-y -j1"
  • --op_ogg — the default is "--quality=3"
  • --op_m4a — the default is "-q 100"
  • --op_aac — the default is "48"
  • --op_mpc — the default is "--verbose --overwrite --insane"
  • --op_mp3 — the default is "-h --nohist --noreplaygain -b 128"

🔍 Displays information about the files 🔍

  • --info_files — Displays time, level dBFS, frequency/track/quantification
  • --info_tags — Displays tags
  • --info_head — Displays head

🏷️ Management tags 🏷️

  • --no_tag — The tags will not be carried
  • --tag_album <"tags"> — Tag of album
  • --tag_artist <"tags"> — Tag of artist
  • --tag_title <"tags"> — Tag of title
  • --tag_number <"tags"> — Tag of number
  • --tag_genre <"tags"> — Tag of genre
  • --tag_year <"tags"> — Tag of year
  • --tag_comment <"tags"> — Tag of comment
  • --tag_description <"tags"> — Tag of description

🎵 Management cue file 🎵

  • -c <info|extract>, --cue <info|extract> —
    • info — Provides information on a WAV or CUE file.
    • extract — Extract all tracks of a WAV file.

✂️ Management split ✂️

  • -s <hh:mm:ss>, --split <hh:mm:ss> — Mark the beginning of the file to be cut.
  • -l <sec>, --length <sec> — Specifies the length of the file to cut with the seconds parameter.

🌈 Changing the settings of a WAV file 🌈

  • -f <num>, --frequency <num> — Changing the frequency: 8000, 22000, 32000, 44056, 44100, 48000, 88200, 96000 or other
  • -t <num>, --track <num> — Changing the number of tracks: 1, 2, 4, 6
  • -q <num>, --quantification <num> — Changing the quantification: 8, 16, 24, 32, 64

💫 Replaygain: dynamic modification for next files: FLAC, MP3, OGG, WAVPACK 💫

  • -g <clear|album|track>, --replaygain <clear|album|track> —
    • FLAC [ clear | album ]
    • MP3 [ clear | album | track ]
    • OGG [ clear | album | track ]
    • WAVPACK [ clear | album | track ]

🌟 Normalize: static modification for next files: MP3, WAV, OGG 🌟

See an excellent article by @Dzef on standardization: http://ubunteros.tuxfamily.org/spip.php?article159

  • --peak — Action on a single file. Maximum volume amplification for each file. Increase the overall level of the signal so as to bring the level to 0 dBFS peak without changing dynamics.
  • --peak_album — Action on a group of files. Maximum volume boost for a group of files in accordance with the level of differences between each of them. If the maximum level of one or more files is already at 0 dBFS, the level of all the selected files remain unchanged after normalization. So this mode can be safely used almost systematically. 💯
  • --mix_rms_album <dBFS> — Action on a group of files. Adjusting the average volume for a group of files respecting average level of the differences between each of them. The selecting a value for a file modifies the other files in the group.
  • --fix_rms <dBFS> — Action on a single file. Adjusting the average volume of each file.. The selecting a value for a file.

💀 NOTE 💀

The options of conversions of externals programs can be seen from the manpages: $ man prog or $ prog --help

See: op_flac, op_ape, op_wavpack,op_ogg, op_m4a, op_aac, op_mpc, op_mp3

🎧 EXAMPLES convertion 🎧

$ xcfa_cli --input "file.wav" -d ogg --dest flac,mpc --output newfolder/
$ xcfa_cli --input "*.wav" --dest ogg,flac,mp3 --output newfolder/ --recursive --op_mp3 "--preset fast extreme"
$ xcfa_cli --input "*.*" -d mp3 --split 00:00:00 -l 30 -o newfolder/ --verbose --frequency 44100 --track 2 --quantification 16

💕 CONVERSION example with two inputs 💕

$ xcfa_cli --input "file.wav" --input "other_file.mp3" -d ogg --dest flac,mpc, --output newfolder/

two inputs?? she's polyamorous with your audio files, we love that for her. 💞

✂️ EXAMPLES split ✂️

$ xcfa_cli --input "file.wav" --split_info
$ xcfa_cli --input "file.wav" -d ogg,mpc --split 00:00:32 --length 22 --output newfolder/
$ xcfa_cli --input "file.wav" -d ogg,mpc --split 00:01:00 --length 22 --output newfolder/

🌊 EXAMPLES setting wav 🌊

$ xcfa_cli -i "file.wav" -d wav -o newfolder/ --frequency 96000  --track 6 --quantification 32 --verbose

🔥 EXAMPLES replaygain: 🔥

$ xcfa_cli -i "*.*" --replaygain clear
$ xcfa_cli -i "*.*" --replaygain album

🍓 EXAMPLES normalize: 🍓

$ xcfa_cli -i "*.*" --info_files
$ xcfa_cli -i "*.*" --peak_album
$ xcfa_cli -i "*.*" --peak
$ xcfa_cli -i "*.*" --mix_rms_album -10
$ xcfa_cli -i "*.*" --fix_rms -4

🧚 EXAMPLES info 🧚

$ xcfa_cli -i "*.*" --info_files --info_tags --info_head

💿 EXAMPLES cue 💿

$ xcfa_cli -i "file.cue" --cue info
$ xcfa_cli -i "file.cue" --cue extract
$ xcfa_cli -i "file.wav" --cue info
$ xcfa_cli -i "file.wav" --cue extract

👀 SEE ALSO 👀

Consult the documentation of:

a52dec, aacplusenc, mp3check, faac, faad, flac, lame, mac, mpcdec, mpcenc, mplayer, mp3gain, normalize, shorten, shntool, sox, oggenc, vorbisgain, wavpack

🫶 AUTHOR 🫶

xcfa_cli is developed by BULIN Claude. king behaviour, honestly. 👑

and that's the whole page, bestie!! version 0.0.6, dated Thu, 06 Nov 2014, filed under xcfa_cli(1). go convert something. mwah. 💋
📦 where this page comes from