.\" 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.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with program; see the file COPYING. If not, write to the
.\" Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
.\" MA 02111-1307, USA.
.\"
.TH xcfa_cli 1 "Thu, 06 Nov 2014" 0.0.6 "Manual: 0.0.6"
.SH NAME
\fBxcfa_cli\fR \- This program is an implementation of xcfa in command line.
.SH DESCRIPTION
.br
\fBxcfa_cli\fR is an application for conversion, normalization, reconfiguring wav files and cut audio files ...
.br
What \fBxcfa_cli\fR can do:
.br
- replaygain on files: flac, mp3, ogg, wavpack
.br
- conversions:
.br
- from files:
.br
wav, flac, ape, wavpack, ogg, m4a, mpc, mp3, wma, shorten, rm, dts, aif, ac3
.br
- to files:
.br
wav, flac, ape, wavpack, ogg, m4a, mpc, mp3, aac
.br
- conversion settings for file management:
.br
flac, ape, wavpack, ogg, m4a, aac, mpc, mp3
.br
- management tags
.br
- management cue wav file
.br
- manipulation of the frequency, track and bit wav files
.br
- standardization on files: wav, mp3, ogg
.br
- cuts (split) wav files
.br
- displaying information on files
.SH SYNOPSIS
\fBxcfa_cli\fP [\fI \fB\-i\fP "file.*"\fR ][\fI \fB\-d\fP wav\fB,\fImpc\fB,\fI...\fR ][\fI OPTIONS \fR]
.SH OPTIONS
.TP
\fB\-\-verbose\fR
Verbose mode
.TP
\fB\-h \-\-help\fR
Print help mode and quit
.TP
\fB\-i \fI<"file.type">\fB \-\-input \fI<"file.type">\fR
Input name file to convert in inverted commas: \fB\-\-input \fI"*.flac"\fR
.br
Type input files: wav, flac, ape, wavpack, ogg, m4a, mpc, mp3, wma, shorten, rm, dts, aif, ac3
.TP
\fB\-o \fI\fB \-\-output \fI\fR
Destination folder. By default in the source file folder.
.TP
\fB\-d \fI\fB \-\-dest \fI\fR
Destination file: wav, flac, ape, wavpack, ogg, m4a, mpc, mp3, aac
.TP
\fB\-r \-\-recursion\fR
Recursive search
.TP
\fB\-e \-\-ext2src\fR
Extract in the source folder. This option is useful with '\fB\-\-recursion\fR'
.TP
\fB\-\-nice \fR
Change the priority of running processes in the interval: 0 .. 20
.TP
Management options with default parameters:
.TP
\fB\-\-op_flac \fI<"\-5">\fR
.TP
\fB\-\-op_ape \fI<"c2000">\fR
.TP
\fB\-\-op_wavpack \fI<"\-y \-j1">\fR
.TP
\fB\-\-op_ogg \fI<"\-\-quality=3">\fR
.TP
\fB\-\-op_m4a \fI<"\-q 100">\fR
.TP
\fB\-\-op_aac \fI<"48">\fR
.TP
\fB\-\-op_mpc \fI<"\-\-verbose \-\-overwrite \-\-insane">\fR
.TP
\fB\-\-op_mp3 \fI<"\-h \-\-nohist \-\-noreplaygain \-b 128">\fR
.TP
Displays information about the files:
.TP
\fB\-\-info_files\fR
Displays time, level dBFS, frequency/track/quantification
.TP
\fB\-\-info_tags\fR
Displays tags
.TP
\fB\-\-info_head\fR
Displays head
.TP
Management tags:
.TP
\fB\-\-no_tag\fR
The tags will not be carried
.TP
\fB\-\-tag_album \fI<"tags">\fR
Tag of album
.TP
\fB\-\-tag_artist \fI<"tags">\fR
Tag of artist
.TP
\fB\-\-tag_title \fI<"tags">\fR
Tag of title
.TP
\fB\-\-tag_number \fI<"tags">\fR
Tag of number
.TP
\fB\-\-tag_genre \fI<"tags">\fR
Tag of genre
.TP
\fB\-\-tag_year \fI<"tags">\fR
Tag of year
.TP
\fB\-\-tag_comment \fI<"tags">\fR
Tag of comment
.TP
\fB\-\-tag_description \fI<"tags">\fR
Tag of description
.TP
Management cue file:
.TP
\fB\-c \fI \fB\-\-cue \fI\fR
.br
\fBinfo\fR Provides information on a WAV or CUE file.
.br
\fBextract\fR Extract all tracks of a WAV file.
.TP
Management split:
.TP
\fB\-s \fI \fB\-\-split \fI\fR
Mark the beginning of the file to be cut.
.TP
\fB\-l \fI \fB\-\-length \fI\fR
Specifies the length of the file to cut with the seconds parameter.
.TP
Changing the settings of a WAV file:
.TP
\fB\-f \fI \fB\-\-frequency \fI\fR
Changing the frequency: 8000, 22000, 32000, 44056, 44100, 48000, 88200, 96000 or other
.TP
\fB\-t \fI \fB\-\-track \fI\fR
Changing the number of tracks: 1, 2, 4, 6
.TP
\fB\-q \fI \fB\-\-quantification \fI\fR
Changing the quantification: 8, 16, 24, 32, 64
.TP
Replaygain: dynamic modification for next files: FLAC, MP3, OGG, WAVPACK
.TP
\fB\-g \fI \fB\-\-replaygain \fI\fR
FLAC [ \fIclear\fR | \fIalbum\fR ]
.br
MP3 [ \fIclear\fR | \fIalbum\fR | \fItrack\fR ]
.br
OGG [ \fIclear\fR | \fIalbum\fR | \fItrack\fR ]
.br
WAVPACK [ \fIclear\fR | \fIalbum\fR | \fItrack\fR ]
.TP
Normalize: static modification for next files: MP3, WAV, OGG
See an excellent article by @Dzef on standardization: http://ubunteros.tuxfamily.org/spip.php?article159
.TP
\fB\-\-peak\fR
.br
Action on a single file.
.br
Maximum volume amplification for each file.
.br
Increase the overall level of the signal so as to bring the level to 0 dBFS peak without changing dynamics.
.TP
\fB\-\-peak_album\fR
.br
Action on a group of files.
.br
Maximum volume boost for a group of files in accordance with the level of differences between each of them.
.br
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.
.TP
\fB\-\-mix_rms_album \fI\fR
.br
Action on a group of files.
.br
Adjusting the average volume for a group of files respecting average level of the differences between each of them.
.br
The selecting a value for a file modifies the other files in the group.
.TP
\fB\-\-fix_rms \fI\fR
.br
Action on a single file.
.br
Adjusting the average volume of each file..
The selecting a value for a file.
.SH NOTE
The options of conversions of externals programs can be seen from the manpages: $ \fBman prog\fR or $ \fBprog \-\-help\fR
.br
See: \fBop_flac, op_ape, op_wavpack,op_ogg, op_m4a, op_aac, op_mpc, op_mp3\fR
.SH EXAMPLES convertion
$ xcfa_cli \-\-input "file.wav" \-d ogg \-\-dest flac,mpc \-\-output newfolder/
.br
$ xcfa_cli \-\-input "*.wav" \-\-dest ogg,flac,mp3 \-\-output newfolder/ \-\-recursive \-\-op_mp3 "\-\-preset fast extreme"
.br
$ xcfa_cli \-\-input "*.*" -d mp3 \-\-split 00:00:00 \-l 30 -o newfolder/ \-\-verbose \-\-frequency 44100 \-\-track 2 \-\-quantification 16
.SH CONVERSION example with two inputs
$ xcfa_cli \-\-input "file.wav" \-\-input "other_file.mp3" \-d ogg \-\-dest flac,mpc, \-\-output newfolder/
.SH EXAMPLES split
$ xcfa_cli \-\-input "file.wav" \-\-split_info
.br
$ xcfa_cli \-\-input "file.wav" \-d ogg,mpc \-\-split 00:00:32 \-\-length 22 \-\-output newfolder/
.br
$ xcfa_cli \-\-input "file.wav" \-d ogg,mpc \-\-split 00:01:00 \-\-length 22 \-\-output newfolder/
.SH EXAMPLES setting wav
$ xcfa_cli \-i "file.wav" \-d wav \-o newfolder/ \-\-frequency 96000 \-\-track 6 \-\-quantification 32 \-\-verbose
.SH EXAMPLES replaygain:
$ xcfa_cli \-i "*.*" \-\-replaygain clear
.br
$ xcfa_cli \-i "*.*" \-\-replaygain album
.SH EXAMPLES normalize:
$ xcfa_cli \-i "*.*" \-\-info_files
.br
$ xcfa_cli \-i "*.*" \-\-peak_album
.br
$ xcfa_cli \-i "*.*" \-\-peak
.br
$ xcfa_cli \-i "*.*" \-\-mix_rms_album \-10
.br
$ xcfa_cli \-i "*.*" \-\-fix_rms \-4
.SH EXAMPLES info
$ xcfa_cli \-i "*.*" \-\-info_files \-\-info_tags \-\-info_head
.SH EXAMPLES cue
$ xcfa_cli \-i "file.cue" \-\-cue info
.br
$ xcfa_cli \-i "file.cue" \-\-cue extract
.br
$ xcfa_cli \-i "file.wav" \-\-cue info
.br
$ xcfa_cli \-i "file.wav" \-\-cue extract
.SH SEE ALSO
Consult the documentation of:
.br
a52dec, aacplusenc, mp3check, faac, faad, flac, lame, mac, mpcdec, mpcenc, mplayer, mp3gain, normalize, shorten, shntool, sox, oggenc, vorbisgain, wavpack
.SH AUTHOR
\fBxcfa_cli\fP is developed by BULIN Claude