.TH "AUDIOTOOLS-CONFIG" 1 "2018-06-29" "" "Audio Tools Configuration Manager"
.SH NAME
audiotools-config \- manage Python Audio Tools configuration
.SH SYNOPSIS
audiotools-config [OPTIONS]
.SH DESCRIPTION
.PP
audiotools-config is the Python Audio Tools configuration manager. When called without arguments, it displays the system's current configuration. By specifying various configuration arguments, it modifies the user's $(HOME)/.audiotools.cfg file with new values.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
show a list of options and exit
.TP
\fB\-I\fR, \fB\-\-interactive\fR
edit options interactively
.TP
\fB\-V\fR, \fB\-\-verbose\fR=\fIVERBOSITY\fR
The level of output to display. Choose between 'normal', 'quiet' and 'debug'.
.SH TRANSCODING OPTIONS
.TP
\fB\-t\fR, \fB\-\-type\fR
When used without the -q option, this sets the default audio type to use when creating new audio files. Otherwise, this is used in conjunction with -q to set the default audio quality for the given type. For a list of available audio formats, try: -t help
.TP
\fB\-q\fR, \fB\-\-quality\fR
The default quality level for a given audio type. For a list of available quality levels, try: -q help
.TP
\fB\-\-format\fR=\fISTRING\fR
The format string to use for new filenames. Template fields are replaced with metadata values when new tracks are created. All other text is left as-is.
.TP
\fB\-j\fR, \fB\-\-joint\fR
the default maximum number of processes to execute at one time
.TP
\fB\-\-replay\-gain\fR=\fIYES/NO\fR
whether to add ReplayGain metadata by default
.SH ID3 OPTIONS
.TP
\fB\-\-id3v2\-version\fR=\fIVERSION\fR
Which version to use for newly created ID3v2 tags. Choose from "id3v2.2", "id3v2.3", "id3v2.4", or "none". All three ID3v2 tag versions are roughly equivalent in terms of supported features, but "id3v2.2" and "id3v2.3" have the widest level of support. If "none" is given, new MP3 files will not be given ID3v2 tags.
.TP
\fB\-\-id3v2\-pad\fR=\fITRUE / FALSE\fR
Whether to pad ID3v2 numerical fields to 2 digits. For example, if "true", track number 1 will be stored as "01" in ID3v2 tags. If false, it will be stored as "1".
.TP
\fB\-\-id3v1\-version\fR=\fIVERSION\fR
Which version to use for newly created ID3v1 tags. Choose from "id3v1.1" or "none". If "none" is given, new MP3 files will not be given ID3v1 tags.
.SH CD LOOKUP OPTIONS
.TP
\fB\-\-use\-musicbrainz\fR=\fIYES/NO\fR
whether to use the MusicBrainz service for CD lookups by default
.TP
\fB\-\-musicbrainz\-server\fR=\fIHOSTNAME\fR
the default MusicBrainz server to use
.TP
\fB\-\-musicbrainz\-port\fR=\fIPORT\fR
the default MusicBrainz port number to use
.TP
\fB\-\-use\-freedb\fR=\fIYES/NO\fR
whether to use the FreeDB service for CD lookups by default
.TP
\fB\-\-freedb\-server\fR=\fIHOSTNAME\fR
the default FreeDB server to use
.TP
\fB\-\-freedb\-port\fR=\fIPORT\fR
the default FreeDB port number to use
.SH SYSTEM OPTIONS
.TP
\fB\-c\fR, \fB\-\-cdrom\fR
the default CD-ROM drive to use
.TP
\fB\-\-cdrom\-read\-offset\fR
the CD-ROM read offset, in PCM samples
.TP
\fB\-\-cdrom\-write\-offset\fR
the CD-ROM write offset, in PCM samples
.TP
\fB\-\-fs\-encoding\fR
the encoding of filenames on the system, such as "UTF-8"
.TP
\fB\-\-io\-encoding\fR
the encoding of text sent to the screen, such as "UTF-8"
.SH BINARIES OPTIONS
.TP
\fB\-\-faac\fR=\fIPATH\fR
.TP
\fB\-\-faad\fR=\fIPATH\fR
.TP
\fB\-\-flac\fR=\fIPATH\fR
.TP
\fB\-\-lame\fR=\fIPATH\fR
.TP
\fB\-\-oggdec\fR=\fIPATH\fR
.TP
\fB\-\-oggenc\fR=\fIPATH\fR
.TP
\fB\-\-speexdec\fR=\fIPATH\fR
.TP
\fB\-\-speexenc\fR=\fIPATH\fR
.TP
\fB\-\-twolame\fR=\fIPATH\fR
.SH FORMAT STRING FIELDS
.TS
tab(:);
| c   s |
| c | c |
| r | l |.
_
Template Fields
Key:Value
=
\fC%(track_number)2.2d\fR:the track's number on the CD
\fC%(track_total)d\fR:the total number of tracks on the CD
\fC%(album_number)d\fR:the CD's album number
\fC%(album_total)d\fR:the total number of CDs in the set
\fC%(album_track_number)s\fR:combination of album and track number
\fC%(track_name)s\fR:the track's name
\fC%(album_name)s\fR:the album's name
\fC%(artist_name)s\fR:the track's artist name
\fC%(performer_name)s\fR:the track's performer name
\fC%(composer_name)s\fR:the track's composer name
\fC%(conductor_name)s\fR:the track's conductor name
\fC%(media)s\fR:the track's source media
\fC%(ISRC)s\fR:the track's ISRC
\fC%(catalog)s\fR:the track's catalog number
\fC%(copyright)s\fR:the track's copyright information
\fC%(publisher)s\fR:the track's publisher
\fC%(year)s\fR:the track's publication year
\fC%(date)s\fR:the track's original recording date
\fC%(suffix)s\fR:the track's suffix
\fC%(basename)s\fR:the track's original name, without suffix
_
.TE
.SH SEE ALSO
.BR audiotools.cfg (5),
.BR cdda2track (1),
.BR cddainfo (1),
.BR cddaplay (1),
.BR coverdump (1),
.BR covertag (1),
.BR coverview (1),
.BR dvda2track (1),
.BR dvdainfo (1),
.BR track2cdda (1),
.BR track2track (1),
.BR trackcat (1),
.BR trackcmp (1),
.BR trackinfo (1),
.BR tracklength (1),
.BR tracklint (1),
.BR trackplay (1),
.BR trackrename (1),
.BR tracksplit (1),
.BR tracktag (1),
.BR trackverify (1)
.SH AUTHOR
Brian Langenberger