1MP3FS(1) User Commands MP3FS(1)
2
6 mp3fs - mounts and transcodes FLACs and OGGs to MP3s on the fly
7
9 mp3fs [OPTION]... IN_DIR OUT_DIR
10
12 The mp3fs(1) command will mount the directory IN_DIR on OUT_DIR.
13 Thereafter, accessing OUT_DIR will show the contents of IN_DIR, with
14 all FLAC/Ogg Vorbis files transparently renamed and transcoded to MP3
15 format upon access.
16
18 -b, -obitrate=RATE
19 Set the bitrate to use for encoding. Acceptable values for RATE
20 are any which are allowed by the MP3 format. According to the
21 manual for LAME, this means:
22 For sampling frequencies of 32, 44.1, and 48 kHz, RATE can be
24 among 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256,
25 and 320.
26 For sampling frequencies of 16, 22.05, and 24 kHz, RATE can be
28 among 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, and
29 160.
30 When in doubt, it is recommended to choose a bitrate among 96,
32 112, 128, 160, 192, 224, 256, and 320. If not specified, RATE
33 defaults to 128.
34 -d, -odebug
36 Enable debug output. This will result in a large quantity of
37 diagnostic information being printed to stderr as the program
38 runs. This option will normally not be used. It implies -f.
39 -f Run in the foreground instead of detaching from the terminal.
41 --gainmode, -ogainmode=MODE
43 Set mode to use for interpreting ReplayGain tags. The allowed
44 values for MODE are:
45 0 - Ignore all ReplayGain tags.
47 1 - Prefer album gain tag, but fall back to track gain if album
49 gain is not present.
50 2 - Use track gain if present.
52 --gainref, -ogainref=REF
54 Set the reference loudness in decibels to adjust ReplayGain
55 tags. ReplayGain software usually defaults to a loudness of 89
56 dB, but if this is too quiet, a higher value can be set here,
57 causing adjustment of ReplayGain values in tags.
58 -h, --help
60 Print usage information.
61 --log_format, -olog_format=FORMAT
63 Specify the format to use for log messages, with the following
64 substitutions:
65 %I - thread ID
67 %L - log level
69 %M - log message
71 %T - time, formatted as YYYY-MM-DD HH:MM:SS
73 The default is "[%T] tid=%I %L: %M".
75 --log_maxlevel, -olog_maxlevel=LEVEL
77 Set the maximum level of messages to log, either ERROR, INFO, or
78 DEBUG. Defaults to INFO, and forced to DEBUG in debug mode.
79 Note that this does not enable logging; other log flags must be
80 set to specify where to log.
81 --log_stderr, -olog_stderr
83 Output logging messages to stderr. Enabled in debug mode.
84 --log_syslog, -olog_syslog
86 Output logging messages to the system log.
87 --logfile, -ologfile=FILE
89 Set the file to log to. By default, no log file will be
90 written.
91 --quality, -oquality=QUALITY
93 Set quality for encoding, as understood by LAME. The slowest
94 and best quality is 0, while 9 is the fastest and worst quality.
95 The default value is 5, although according to the LAME manual, 2
96 is recommended.
97 -s Force single-threaded operation.
99 --statcachesize, -ostatcachesize=SIZE
101 Set the number of cached stat entries to store. This is needed
102 for reasonable performance when VBR is enabled. Each entry
103 takes 100-200 bytes of memory. Entries are evicted from the
104 cache in least recently used order.
105 --vbr, -ovbr
107 Use variable bit rate encoding. When enabled, the -b or
108 -obitrate options set the maximum bit rate. If enabled, the
109 --statcachesize or -ostatcachesize options are strongly
110 recommended.
111 -V, --version
113 Output version information.
114
116 Copyright (C) 2006-2008 David Collett and 2008-2013 K. Henriksson.
117 This is free software: you are free to change and redistribute it under
118 the terms of the GNU General Public License (GPL) version 3 or later.
119 This manual is copyright (C) 2010-2020 K. Henriksson and may be
121 distributed under the GNU Free Documentation License (GFDL) 1.3 or
122 later with no invariant sections, or alternatively under the GNU
123 General Public License (GPL) version 3 or later.
124mp3fs 1.1.1 March 2021 MP3FS(1)