--- name: "xcfa_cli.1" section: "1" platform: "linux" package: "xcfa" version: "5.0.2-3" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/xcfa_cli.1" --- # xcfa\_cli.1(1) This program is an implementation of xcfa in command line. ## NAME **xcfa\_cli** - This program is an implementation of xcfa in command line. ## DESCRIPTION **xcfa\_cli** is an application for conversion, normalization, reconfiguring wav files and cut audio files ...\ What **xcfa\_cli** can do:\ \ \- 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 ## SYNOPSIS **xcfa\_cli** \[ **-i** *"file.\*"* \]\[ **-d** *wav***,***mpc***,***...* \]\[ *OPTIONS* \] ## OPTIONS - **--verbose** Verbose mode - **-h --help** Print help mode and quit - **-i** *\<"file.type"\>* **--input** *\<"file.type"\>* Input name file to convert in inverted commas: **--input** *"\*.flac"*\ Type input files: wav, flac, ape, wavpack, ogg, m4a, mpc, mp3, wma, shorten, rm, dts, aif, ac3 - **-o** *\* **--output** *\* Destination folder. By default in the source file folder. - **-d** *\* **--dest** *\* Destination file: wav, flac, ape, wavpack, ogg, m4a, mpc, mp3, aac - **-r --recursion** Recursive search - **-e --ext2src** Extract in the source folder. This option is useful with '**--recursion**' - **--nice \** Change the priority of running processes in the interval: 0 .. 20 - Management options with default parameters: - **--op\_flac** *\<"-5"\>* - **--op\_ape** *\<"c2000"\>* - **--op\_wavpack** *\<"-y -j1"\>* - **--op\_ogg** *\<"--quality=3"\>* - **--op\_m4a** *\<"-q 100"\>* - **--op\_aac** *\<"48"\>* - **--op\_mpc** *\<"--verbose --overwrite --insane"\>* - **--op\_mp3** *\<"-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** *\ --cue** *\* **info** Provides information on a WAV or CUE file.\ **extract** Extract all tracks of a WAV file. - Management split: - **-s** *\* **--split** *\* Mark the beginning of the file to be cut. - **-l** *\* **--length** *\* Specifies the length of the file to cut with the seconds parameter. - Changing the settings of a WAV file: - **-f** *\* **--frequency** *\* Changing the frequency: 8000, 22000, 32000, 44056, 44100, 48000, 88200, 96000 or other - **-t** *\* **--track** *\* Changing the number of tracks: 1, 2, 4, 6 - **-q** *\* **--quantification** *\* Changing the quantification: 8, 16, 24, 32, 64 - Replaygain: dynamic modification for next files: FLAC, MP3, OGG, WAVPACK - **-g** *\* **--replaygain** *\* 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** *\* 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** *\* 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/ ## 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