# Install mp3fs with Homebrew, apt, dnf, MacPorts, Nix

Read-only FUSE file system: transcodes audio formats to MP3. Version 1.1.1 via Homebrew; verified 2026-06-21. Also installable with debian: sudo apt install mp3fs.

## Install

```sh
sudo av install brew:mp3fs
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mp3fs
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install mp3fs
```

  Evidence: MacPorts ports tree: fuse/mp3fs/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Debian apt (92%):

```sh
sudo apt install mp3fs
```

  Evidence: Debian stable package indexes: mp3fs from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install mp3fs
```

  Evidence: Fedora Rawhide package metadata: mp3fs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#mp3fs
```

  Evidence: nixpkgs package indexes: pkgs/by-name/mp/mp3fs/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:mp3fs
- **Package manager:** Homebrew
- **Version:** 1.1.1
- **Source summary:** Read-only FUSE file system: transcodes audio formats to MP3
- **Homepage:** <https://khenriks.github.io/mp3fs/>
- **Repository:** <https://github.com/khenriks/mp3fs>
- **Last updated:** 2026-06-21T17:39:42-04:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- mp3fs (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.1.1
## Project history and usage

mp3fs is a read-only FUSE filesystem that presents FLAC and Ogg Vorbis files as MP3 files by transcoding on access. The original author and maintainer was David Collett from 2006 to 2008; K. Henriksson became the primary author and maintainer afterward. The manual records the same authorship split, with copyright for David Collett in 2006-2008 and K. Henriksson afterward.

### Project history

The project's role is a neat filesystem trick for lossless music collections. A user mounts a source directory and a mountpoint, and applications browsing the mountpoint see .mp3 names for the underlying FLAC/Ogg files. Reads initialize decoders and encoders, fill an internal per-file buffer, and emit MP3 data without requiring the user to keep a second converted library. The README gives examples for FUSE mounts and fstab entries, and describes practical uses such as feeding hardware or software that only understands MP3.

### How it is used

Its major milestones track the broadening of that original idea. The news file lists an initial 0.01 release in 2006, a 0.30 release that added better documentation, bitrate selection, LAME quality settings, and metadata improvements, a 0.9 rewrite of the transcoding code around codec classes, and a 1.0 release that added Ogg Vorbis decoding, VBR MP3 encoding, logging improvements, and a more modern C++11 codebase. In package managers it sits at the intersection of audio tooling and filesystem integration; Homebrew exposes it as a FUSE-dependent formula with FLAC, LAME, libid3tag, and libvorbis in its dependency chain.

### Sources

- <https://formulae.brew.sh/formula/mp3fs>
- <https://github.com/khenriks/mp3fs>
- <https://khenriks.github.io/mp3fs/>
- <https://khenriks.github.io/mp3fs/mp3fs.1.html>
- <https://raw.githubusercontent.com/khenriks/mp3fs/master/NEWS.md>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Other Package-Manager Records

- Debian apt - mp3fs - 1.1.1-1+b3: normalized package name match | Debian stable package indexes: mp3fs from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | FUSE filesystem for transcoding FLAC to MP3 on the fly | https://khenriks.github.io/mp3fs/
- Nix - mp3fs: normalized package name match | nixpkgs package indexes: pkgs/by-name/mp/mp3fs/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - mp3fs - 1.1.1-1build4: normalized package name match | Ubuntu 24.04 LTS package indexes: mp3fs from https://archive.ubuntu.com/ubuntu/dists/noble/multiverse/binary-amd64/Packages.gz | FUSE filesystem for transcoding FLAC to MP3 on the fly | https://khenriks.github.io/mp3fs/
- dnf - mp3fs - 1.1.1-17.fc45: normalized package name match | Fedora Rawhide package metadata: mp3fs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | FUSE filesystem to transcode FLAC to MP3 on the fly | https://khenriks.github.io/mp3fs/
- MacPorts - mp3fs: normalized package name match | MacPorts ports tree: fuse/mp3fs/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/mp3fs.yml](https://github.com/mxcl/pkgdb/blob/main/combined/mp3fs.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph