xcfa_cli.1 (1)

Leading comments

xcfa_cli
Copyright (C) 2014 BULIN Claude

xcfa_cli! is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or
(at your option) any later version.

xcfa_cli! is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

Y...

(The comments found at the beginning of the groff file "man1/xcfa_cli.1.1".)

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 <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

-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 <"-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 <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: 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/

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