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.
18 Additionally, any cover art (stored in the directory structure as
19 folder.jpg) will be duplicated in the target lossy directories.
20
22 transflac sources two configuration files on startup - /etc/trans‐
23 flac.conf and $HOME/.transflac.conf, in that order.
24 The configuration options stated in those files can be overridden by
26 providing the appropriate flags at runtime.
27 The configuration variables have to be set as follows:
29 VARIABLE="value"
31 "value" needs to be quoted.
32 All shell escaping/quoting rules apply.
34 Here is a list of options transflac recognizes:
36 input_flac_dir=""
38 Specifies the directory starting point which will be recursively
39 search for FLAC audio files. All FLAC audio files in the direc‐
40 tory structure will be converted to the specified lossy codec.
41 Default value is "$1" which is arg1 from the command line invo‐
42 cation. This value is case sensitive. Any symlinks that are
43 encountered will be resolved and the physical path will be dis‐
44 played.
45 output_lossy_dir=""
47 Specifies the target directory which will be used to store the
48 lossy audio files which are created during the conversion
49 process. Default value is "$2" which is arg2 from the command
50 line invocation. This value is case sensitive. Any symlinks
51 that are encounted will be resolved and the physical path will
52 be displayed.
53 lossy_codec=""
55 Specifies the lossy codec which will be used to convert the FLAC
56 audio files. Default value is "$3" which is arg3 from the com‐
57 mand line invocation. This value is NOT case sensitive. OPUS
58 generally will provide the best sound quality for a given file‐
59 size or bitrate - and is the recommended codec.
60 Valid values are: OPUS | OGG | AAC | MP3
61 codec_quality=""
63 Specifies the quality preset which will be used to encode the
64 lossy audio files. Default value is "$4" which is arg4 from the
65 command line invocation. This value is NOT case sensitive.
66 OPUS STANDARD quality provides Full bandwidth stereo music, good
67 quality approaching transparency - and is the recommended set‐
68 ting.
69 Valid values are: LOW | MEDIUM | STANDARD | HIGH | PREMIUM
70 ┌──────┬─────────┬──────────┬──────────┬──────────┬──────────┐
72 │CODEC │ LOW │ MEDIUM │ STANDARD │ HIGH │ PREMIUM │
73 ├──────┼─────────┼──────────┼──────────┼──────────┼──────────┤
74 │OPUS │ 48 kbps │ 64 kbps │ 96 kbps │ 128 kbps │ 192 kbps │
75 ├──────┼─────────┼──────────┼──────────┼──────────┼──────────┤
76 │OGG │ 80 kbps │ 96 kbps │ 112 kbps │ 128 kbps │ 160 kbps │
77 ├──────┼─────────┼──────────┼──────────┼──────────┼──────────┤
78 │AAC │ 40 kbps │ 80 kbps │ 96 kbps │ 128 kbps │ 224 kbps │
79 ├──────┼─────────┼──────────┼──────────┼──────────┼──────────┤
80 │MP3 │ 85 kbps │ 100 kbps │ 115 kbps │ 130 kbps │ 165 kbps │
81 └──────┴─────────┴──────────┴──────────┴──────────┴──────────┘
83 Possible ways one can call transflac:
84 transflac
86 "You will be prompted to enter all options. If you have custom‐
87 ized options in $HOME/.transflac.conf those values will be sub‐
88 stituted.
89 transflac [input_flac_dir] [output_lossy_dir] [lossy_codec]
91 [codec_quality]
92 transflac processing will proceed with the options entered on
93 the command line.
94
96 transflac requires the following backend tools to work:
97 * opus-tools - Required to convert files to the OPUS lossy format
99 * vorbis-tools - Required to convert files to the OGG Vorbis lossy
101 format
102 * ffmpeg - Required to convert files to the AAC or MP3 lossy for‐
104 mats
105 * flac - Required to convert files from the FLAC lossless format
107 * rsync - Required to copy cover art files to the new lossy format
109 directory structure
110 * figlet - Required to facilate display formatting
112
114 opusenc(1), oggenc(1), flac(1), ffmpeg(1)
115
117 Gerald Cox <gbcox@fedoraproject.org>
118
120 https://bitbucket.org/gbcox/transflac/
121 transflac(1)