1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
MP3FS
=====
:Maintainer: Kristofer Henriksson
:Authors: - Kristofer Henriksson
- David Collett
:Web site: http://khenriks.github.com/mp3fs/
.. contents::
We're pleased to announce the release of version 0.31 of mp3fs! This is a
small update which fixes a few bugs and adds configuration options for the
ReplayGain support.
Introduction
------------
MP3FS is a read-only FUSE filesystem which transcodes audio formats
(currently FLAC) to MP3 on the fly when opened and read. This was
written to enable me to use my FLAC collection with software and/or
hardware which only understands the MP3 format e.g. gmediaserver to a
Netgear MP101 MP3 player.
It is also a novel alternative to traditional MP3 encoders. Just use your
favorite file browser to select the files you want encoded and copy them
somewhere!
How it Works
------------
When a file is opened, the decoder and encoder are initialised and
the file metadata is read. At this time the final filesize can be
determined as we only support constant bitrate (CBR) MP3 files.
As the file is read, it is transcoded into an internal per-file
buffer. This buffer continues to grow while the file is being read
until the whole file is transcoded in memory. The memory is freed
only when the file is closed. This simplifies the implementation.
Seeking within a file will cause the file to be transcoded up to the
seek point (if not already done). This is not usually a problem
since most programs will read a file from start to finish. Future
enhancements may provide true random seeking.
ID3 version 2.4 and 1.1 tags are created from the vorbis comments in
the FLAC file. They are located at the start and end of the file
respectively.
A special optimisation is made so that applicatins which scan for
id3v1 tags do not have to wait for the whole file to be transcoded
before reading the tag. This *dramatically* speeds up such
applications.
For build instructions see the bundled INSTALL file.
Usage
-----
**NOTE:** The command line format changed in version 0.30, making bitrate
a command-line or mount option of the program.
Mount your filesystem like this::
mp3fs [-b bitrate] musicdir mountpoint [-o fuse_options]
For example,
::
mp3fs -b 128 /mnt/music /mnt/mp3 -o allow_other,ro
In recent versions of FUSE and mp3fs, the same can be achieved with the
following entry in ``/etc/fstab``::
mp3fs#/mnt/music /mnt/mp3 fuse allow_other,ro,bitrate=128 0 0
Note that this requires /sbin/mount.fuse from the fuse-utils package.
At this point the filesystem is ready to be used. Here are the original
files::
dave@bender:~/mp3fs$ ls -l /mnt/music/Smashing\ Pumpkins/Pisces\ Iscariot/
total 345316
-rw-r--r-- 1 mythtv mythtv 10267876 2005-06-19 18:36 01 - Soothe.flac
-rw-r--r-- 1 mythtv mythtv 23512276 2005-06-19 18:36 02 - Frail And Bedazzled.flac
-rw-r--r-- 1 mythtv mythtv 23332187 2005-06-19 18:36 03 - Plum.flac
-rw-r--r-- 1 mythtv mythtv 26402936 2005-06-19 18:36 04 - Whir.flac
-rw-r--r-- 1 mythtv mythtv 21591252 2005-06-19 18:36 05 - Blew Away.flac
-rw-r--r-- 1 mythtv mythtv 16719855 2005-06-19 18:36 06 - Pissant.flac
-rw-r--r-- 1 mythtv mythtv 33454889 2005-06-19 18:36 07 - Hello Kitty Kat.flac
-rw-r--r-- 1 mythtv mythtv 32073747 2005-06-19 18:36 08 - Obscured.flac
-rw-r--r-- 1 mythtv mythtv 17614217 2005-06-19 18:36 09 - Landslide.flac
-rw-r--r-- 1 mythtv mythtv 65406696 2005-06-19 18:36 10 - Starla.flac
-rw-r--r-- 1 mythtv mythtv 18651734 2005-06-19 18:36 11 - Blue.flac
-rw-r--r-- 1 mythtv mythtv 25055200 2005-06-19 18:36 12 - Girl Named Sandoz.flac
-rw-r--r-- 1 mythtv mythtv 28060023 2005-06-19 18:36 13 - La Dolly Vita.flac
-rw-r--r-- 1 mythtv mythtv 11432008 2005-06-19 18:36 14 - Spaced.flac
And now you can use the (virtual) MP3 files from the mp3fs mountpoint::
dave@bender:~/mp3fs$ ls -l /mnt/mp3/Smashing\ Pumpkins/Pisces\ Iscariot/
total 53896
-rw-r--r-- 1 mythtv mythtv 2446849 2005-06-19 18:36 01 - Soothe.mp3
-rw-r--r-- 1 mythtv mythtv 3197934 2005-06-19 18:36 02 - Frail And Bedazzled.mp3
-rw-r--r-- 1 mythtv mythtv 3467503 2005-06-19 18:36 03 - Plum.mp3
-rw-r--r-- 1 mythtv mythtv 4003745 2005-06-19 18:36 04 - Whir.mp3
-rw-r--r-- 1 mythtv mythtv 3414845 2005-06-19 18:36 05 - Blew Away.mp3
-rw-r--r-- 1 mythtv mythtv 2413413 2005-06-19 18:36 06 - Pissant.mp3
-rw-r--r-- 1 mythtv mythtv 4348572 2005-06-19 18:36 07 - Hello Kitty Kat.mp3
-rw-r--r-- 1 mythtv mythtv 5132656 2005-06-19 18:36 08 - Obscured.mp3
-rw-r--r-- 1 mythtv mythtv 3099704 2005-06-19 18:36 09 - Landslide.mp3
-rw-r--r-- 1 mythtv mythtv 10542719 2005-06-19 18:36 10 - Starla.mp3
-rw-r--r-- 1 mythtv mythtv 3210041 2005-06-19 18:36 11 - Blue.mp3
-rw-r--r-- 1 mythtv mythtv 3449127 2005-06-19 18:36 12 - Girl Named Sandoz.mp3
-rw-r--r-- 1 mythtv mythtv 4098213 2005-06-19 18:36 13 - La Dolly Vita.mp3
-rw-r--r-- 1 mythtv mythtv 2337344 2005-06-19 18:36 14 - Spaced.mp3
dave@bender:~/mp3fs$ id3info /mnt/mp3/Smashing\ Pumpkins/Pisces\ Iscariot/01\ -\ Soothe.mp3
*** Tag information for /mnt/mp3/Smashing Pumpkins/Pisces Iscariot/01 - Soothe.mp3
=== TSSE (Software/Hardware and settings used for encoding): LAME v3.96.1
=== TIT2 (Title/songname/content description): Soothe
=== TPE1 (Lead performer(s)/Soloist(s)): Smashing Pumpkins
=== TALB (Album/Movie/Show title): Pisces Iscariot
=== TRCK (Track number/Position in set): 1
*** mp3 info
MPEG1/layer III
Bitrate: 128KBps
Frequency: 44KHz
dave@bender:~/mp3fs$ time cp /mnt/mp3/Smashing\ Pumpkins/Pisces\ Iscariot/01\ -\ Soothe.mp3 /tmp/
real 0m12.917s
user 0m0.004s
sys 0m0.020s
dave@bender:~/mp3fs$ xmms /mnt/mp3/Smashing\ Pumpkins/Pisces\ Iscariot/* &
Download
--------
Releases are made through our website on GitHub.
There are now two different branches of mp3fs development:
- Active development will occur on the main branch, which has version
numbers 0.20 or higher. FLAC version 1.1.4 or higher is
required.
- Only bug fixes will happen on the legacy branch, which has version
numbers less than 0.20. Any version of FLAC is supported.
The reason for two branches is to maintain compatibility with old versions
of FLAC. This is necessary because a major Linux vendor provides only an
ancient version of FLAC in several of their releases.
The bottom line is that if you have a suitable version of FLAC, you should
use the very latest version of mp3fs. If not, you can use a version from
the legacy branch.
Development
-----------
MP3FS uses Git for revision control. You can obtain the full repository
with::
git clone git://github.com/khenriks/mp3fs.git
MP3FS is written in C and uses the following libraries:
- `FUSE <http://fuse.sourceforge.net/>`_ (>= 2.6.0)
- `FLAC <http://flac.sourceforge.net/>`_ (>= 1.1.4 unless using mp3fs <0.20)
- `LAME <http://lame.sourceforge.net/>`_
- `libid3tag <http://www.underbit.com/products/mad/>`_
License
-------
This program can be distributed under the terms of the GNU GPL version 3
or later. You can find it `online
<http://www.gnu.org/licenses/gpl-3.0.html>`_ or in the mp3fs distribution
in the COPYING file.
|
