mfe-player 0.3.7

Music For Everyone — a plugin-driven, terminal-native music player that tells subscriptions to get lost
# Configuration

> Part of the [MFE Player]../README.md manual.

Every `config.toml` key is optional; this page lists them and where each file lives.

---

## ⚙️ Config

`~/.config/mfe-player/config.toml` — every key is optional.

```toml
theme = "mfe"             # or "wallpaper" to sample your desktop
transparent = false       # Alt+W; let the terminal show what is behind it
wallpaper = ""            # explicit image for theme = "wallpaper"; empty = detect
seek_step = 5
long_seek_step = 30
volume_step = 5
max_volume = 130          # ceiling for +/- and the clickable meter
speed_step = 0.1          # [ and ] speed step
prefetch = true
radio = false
autoplay = "taste"        # off | similar | taste (what happens when the queue ends)
taste_enabled = true      # learn the local profile from plays and skips
taste_filter = true       # keep slowed/sped-up/nightcore/AI-cover slop out of autoplay
autoplay_explore = 0.12   # epsilon-greedy share for the bandit (0..1)
autoplay_probe = true     # occasional deliberate out-of-profile track
autoplay_probe_every = 10 # ...every N autoplay picks
mouse = true
cava = true
cava_position = "right"   # right | left
cava_bars = 28
cava_hidden = false       # Alt+S: remove the panel, keep the audio-reactive theme
normalize = false
eq = "flat"               # flat | bass | vocal | night | loud
audio_device = ""         # e.g. "alsa/hdmi:CARD=HDMI"
fade_seconds = 0          # 2-4 = gentle crossfade feel, 0 = off
replaygain = "off"        # off | track | album
eq_gains = [0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0]
mpris = true
library_paths = ["~/Music"]   # scanned on launch; press R in the library view to rescan
listenbrainz_token = ""       # optional; empty = nothing ever leaves your machine
```

| Path | What lives there |
|---|---|
| `~/.config/mfe-player/config.toml` | settings |
| `~/.config/mfe-player/state.json` | queue, playlists, favorites, position |
| `~/.config/mfe-player/plugins/` | provider plugins |
| `~/.cache/mfe-player/downloads/` | offline audio |
| `~/.config/mfe-player/library.json` | local library index |
| `~/.cache/mfe-player/artwork/` | downloaded and embedded cover cache |
| `~/.config/mfe-player/mfe-player.m3u` | exported playlists |

Want scrobbles without handing over a social graph? Paste a ListenBrainz user token into `listenbrainz_token` in the config. Plays are submitted from a background thread; if the token is empty, nothing leaves your machine.

---