1transflac(1) General Commands Manual transflac(1)
2
6 transflac - convert FLAC audio files to lossy formats.
7
9 transflac [input_FLAC_directory] [output_lossy_directory] [lossy_for‐
10 mat] [codec_quality]
11
13 The process of converting FLAC files to lossy formats and preserving
14 tag information can be a bit tedious. transflac is designed to auto‐
15 mate this. It will start at the input_flac_directory and recursively
16 walk the directory structure converting each flac audio file to the
17 specified lossy codec - preserving all associated tag information. Ad‐
18 ditionally, any cover art (stored in the directory structure as albu‐
19 mart | cover | folder . gif | jpg | jpeg | png | tiff) will be dupli‐
20 cated in the target lossy directories.
21
23 transflac allows for customization of certain items in the configura‐
24 tion.
25 If you wish to change an option in the configuration, first create a
27 copy: cp /etc/transflac.conf $HOME/.transflac.conf then modify only the
28 $HOME/.transflac.conf version.
29 The configuration variables can be set as follows:
31 VARIABLE="value"
33 "value" needs to be quoted.
34 All shell escaping/quoting rules apply.
36 Here is a list of options transflac recognizes:
38 FIGFONT="small"
40 Default setting is small. This is the font to be used by the
41 FIGlet generated banner.
42 ARTSYNC="YES"
44 Default setting is YES. Album art is automatically sync'd. If
45 you do not wish artwork to be copied, change the setting to ART‐
46 SYNC="NO".
47 input_flac_dir=""
49 Specifies the directory starting point which will be recursively
50 search for FLAC audio files. All FLAC audio files in the direc‐
51 tory structure will be converted to the specified lossy codec.
52 Default value is "$1" which is arg1 from the command line invo‐
53 cation. This value is case sensitive. Any symlinks that are
54 encountered will be resolved and the physical path will be dis‐
55 played.
56 output_lossy_dir=""
58 Specifies the target directory which will be used to store the
59 lossy audio files which are created during the conversion
60 process. Default value is "$2" which is arg2 from the command
61 line invocation. This value is case sensitive. Any symlinks
62 that are encounted will be resolved and the physical path will
63 be displayed.
64 lossy_codec=""
66 Specifies the lossy codec which will be used to convert the FLAC
67 audio files. Default value is "$3" which is arg3 from the com‐
68 mand line invocation. This value is NOT case sensitive. OPUS
69 generally will provide the best sound quality for a given file‐
70 size or bitrate - and is the recommended codec.
71 Valid values are: OPUS | OGG | AAC | MP3
72 codec_quality=""
74 Specifies the quality preset which will be used to encode the
75 lossy audio files. Default value is "$4" which is arg4 from the
76 command line invocation. This value is NOT case sensitive.
77 OPUS STANDARD quality provides Full bandwidth stereo music, good
78 quality approaching transparency - and is the recommended set‐
79 ting.
80 Valid values are: LOW | MEDIUM | STANDARD | HIGH | PREMIUM
81 ┌──────┬─────────┬──────────┬──────────┬──────────┬──────────┐
83 │CODEC │ LOW │ MEDIUM │ STANDARD │ HIGH │ PREMIUM │
84 ├──────┼─────────┼──────────┼──────────┼──────────┼──────────┤
85 │OPUS │ 48 kbps │ 64 kbps │ 96 kbps │ 128 kbps │ 192 kbps │
86 ├──────┼─────────┼──────────┼──────────┼──────────┼──────────┤
87 │OGG │ 80 kbps │ 96 kbps │ 112 kbps │ 128 kbps │ 160 kbps │
88 ├──────┼─────────┼──────────┼──────────┼──────────┼──────────┤
89 │AAC │ 40 kbps │ 80 kbps │ 96 kbps │ 128 kbps │ 224 kbps │
90 ├──────┼─────────┼──────────┼──────────┼──────────┼──────────┤
91 │MP3 │ 85 kbps │ 100 kbps │ 115 kbps │ 130 kbps │ 165 kbps │
92 └──────┴─────────┴──────────┴──────────┴──────────┴──────────┘
93 COLOR OVERRIDES
95 Colors can be modified by assigning a valid color name to the
96 variable names as shown in the sample transflac.conf file. Mono‐
97 chrome or terminal defaults can be obtained by setting the a
98 particular variable name to "DEFAULT". Additional information
99 can be found at TransFLAC website.
100 Available color names: RED, YELLOW, GREEN, BLUE, CYAN, PURPLE,
102 GRAY
103 Placing an "L" in fron of the color designates the "LIGHT" ver‐
105 sion.
106
108 Possible ways one can call transflac:
109 transflac
111 "You will be prompted to enter all options. If you have custom‐
112 ized options in $HOME/.transflac.conf those values will be sub‐
113 stituted.
114 transflac [input_flac_dir] [output_lossy_dir] [lossy_codec]
116 [codec_quality]
117 transflac processing will proceed with the options entered on
118 the command line.
119
121 transflac requires the following backend tools:
122 * opus-tools - Required to convert files to the OPUS lossy format
124 * vorbis-tools - Required to convert files to the OGG Vorbis lossy
126 format
127 * ffmpeg - Required to convert files to the AAC or MP3 lossy for‐
129 mats
130 * flac - Required to convert files from the FLAC lossless format
132 * rsync - Required to copy cover art files to the new lossy format
134 directory structure
135 * figlet - Required to facilate display formatting
137
139 opusenc(1), oggenc(1), flac(1), ffmpeg(1)
140
142 Gerald Cox <gbcox@fedoraproject.org>
143
145 https://bitbucket.org/gbcox/transflac/
146 transflac(1)