Wiki

Clone wiki

transflac / src-tf-conf-override.sh

TransFLAC allows for customization of certain items in the configuration.

If you wish to change an option in the configuration, first create a copy:

cp /etc/transflac.conf $HOME/.transflac.conf 

then modify only the $HOME/.transflac.conf version. Only uncommented lines, will be acted upon. Your version of .transflac.conf does not need to include any lines that start with #. Commented lines are ignored. Examples and additional guidance is provided in transflac.conf.

The configuration variables can be set as follows:

VARIABLE="value" "value" needs to be quoted.

All shell escaping/quoting rules apply.

Here is a list of options transflac recognizes:

FIGFONT="small"

This is the font to be used by the FIGlet generated banner. Default setting is small. Available fonts have a filetype of "flf" and can be found in the following directory: /usr/share/figlet

ARTSYNC="YES"

All valid artwork files are sync'd to the respective lossy directories by default. If you for some reason do not want any artwork files to be copied to the lossy directories, specify ARTSYNC="NO".

input_flac_dir=""

Specifies the directory starting point which will be recursively search for FLAC audio files. All FLAC audio files in the directory structure will be converted to the specified lossy codec. Default value is "$1" which is arg1 from the command line invocation. This value is case sensitive. Any symlinks that are encountered will be resolved and the physical path will be displayed.

output_lossy_dir=""

Specifies the target directory which will be used to store the lossy audio files which are created during the conversion process. Default value is "$2" which is arg2 from the command line invocation. This value is case sensitive. Any symlinks that are encounted will be resolved and the physical path will be displayed.

lossy_codec=""

Specifies the lossy codec which will be used to convert the FLAC audio files. Default value is "$3" which is arg3 from the command line invocation. This value is NOT case sensitive. OPUS generally will provide the best sound quality for a given filesize or bitrate - and is the recommended codec. Valid values are:

OPUS|OGG|AAC|MP3

codec_quality=""

Specifies the quality preset which will be used to encode the lossy audio files. Default value is "$4" which is arg4 from the command line invocation. This value is NOT case sensitive. OPUS STANDARD quality provides Full bandwidth stereo music, good quality approaching transparency - and is the recommended setting.

LOW|MEDIUM|STANDARD|HIGH|PREMIUM  
CODEC LOW MEDIUM STANDARD HIGH PREMIUM
OPUS 48 kbps 64 kbps 96 kbps 128 kbps 192 kbps
OGG 80 kbps 96 kbps 112 kbps 128 kbps 160 kbps
AAC 40 kbps 80 kbps 96 kbps 128 kbps 224 kbps
MP3 85 kbps 100 kbps 115 kbps 130 kbps 165 kbps

COLOR OVERRIDES

Colors can be modified by assigning a valid color name to the variable names shown in the attached annotated screen captures. Monochrome or terminal defaults can be obtained by setting the a particular variable name to "DEFAULT".

Available color names: RED, YELLOW, GREEN, BLUE, CYAN, PURPLE, GRAY

  • Placing a "L" in front of the color designates the "LIGHT" version

transflac_codec_annotated.png

transflac_codec_annotated.png

Updated