Music For Everyone.
A terminal music player that streams, queues, downloads and visualises — with no subscription, no account, and no Electron tab eating your RAM.
The rant · Features · Install · Keys · Daemon · Themes
|
Not a curl | bash person? Every channel installs the same binary:
Binary tarballs for Linux/macOS/Windows live on the releases page. The complete list is in docs/INSTALL.md.
Platforms: Linux is the tested, everything-works target · macOS builds in CI and is solid · Windows is experimental — the native build exists but nobody has certified it on real hardware, so on Windows the reliable path is Docker (docker compose run --rm mfe).
The reason why i build this :
I'm going to be honest with you: I built this because I got tired of being farmed.
I was paying for a music subscription. Then a "lossless" add-on. Then a family plan I didn't need. And after all that, the app still had ads — for the same service — and one song required three taps, two spinners and a page reload. The desktop client sat there using more RAM than my editor, my browser and my whole dev environment combined, to play a 4 MB MP3.
At some point I looked at my terminal, where I already live, and thought: why is my music not here?
Not "why isn't there a web player I can embed". Not "why isn't there a plugin for VS Code". Why is the one place I spend ten hours a day the only place I can't hit space and hear a song?
So I built it. Rust + ratatui + mpv + Python plugins. It started as "can I search and play a song without opening a browser". Then the queue showed up. Then favourites, playlists, lyrics, radio, downloads, MPRIS, a cava panel that actually moves to the audio, and a background daemon that keeps playing when your SSH session drops.
Some things I got tired of, specifically:
- "Your music, anywhere." Except on the one device I use.
- Region locks on songs that are, somehow, available for free elsewhere.
- Hi-Fi tiers so I can hear the ads in higher fidelity.
- "Sign in to continue listening" — to music I already paid for.
- $11.99 a month, forever, for a library I could have ripped in 2006 and owned.
- 4 GB of RAM for a UI that needs one text box and a play button.
No account. No telemetry. No "recommended for you" — I know what I want to listen to, that's why I searched for it. No dark patterns. Just a search box, your music, and every key you need.
This is MFE Player — Music For Everyone. It's MIT-licensed, it's a terminal app, and it does not give a single shit about your engagement metrics.
If this saves you one subscription, one laggy tab, or one "sorry, this content is not available in your region", that's the whole point.
🩹 Recently fixed
The annoying stuff, killed in 0.3.4 / 0.3.5:
- Autoplay used to queue the news. A music search that missed in the song catalogs fell through to the radio directory, and autoplay also searched random title words like
"life mix". Autoplay now only queues real songs (15 s–20 min, no news/talk/podcast titles), skips any live/radio provider, and searches only genre tags. Radio is still there when you ask for it — it just can't sneak into your queue. - Replaying a song started halfway through. The player remembered your last position and per-track bookmarks, so every "play again" picked up mid-song. Replays now always start at 0:00 — Enter, the queue, next/previous and search results alike. (
Ctrl+Bbackground playback keeps playing untouched; pressing Enter on a paused player restarts it from the beginning.) radio = falsein config could be silently overridden by a toggle left over from a previous session. The config now wins on every launch.- npm install on Windows was broken. The platform packages (
mfe-player-win32-*) were rejected by npm's spam detection and never existed. They are nowmfe-player-windows-x64/mfe-player-windows-arm64.
Full history lives in CHANGELOG.md.
🚀 What you actually get
The short list — the complete one lives in docs/FEATURES.md.
| fzf-style search | Songs, artists and albums in one fuzzy list. Enter opens an artist/album page or starts playback. |
| Spotify-ish queue | Queue next, bulk-queue a whole view, reorder with J/K, jump to now playing, clear upcoming, undo mistakes. |
| Plugins, not lock-in | Metadata, streaming and lyrics are separate Python 3 plugins. Provider breaks? The player walks down the list and keeps going. |
| Real background playback | Ctrl+B detaches into a headless daemon. The queue, repeat, shuffle and radio keep running after the TUI is gone. |
| Drive it from any terminal | mfe play, pause, toggle, next, prev, mute, seek +10, shuffle, repeat, volume — bind them to anything, script anything. The queue and repeat state stay correct because the daemon, not mpv, applies them. |
| Offline downloads | d rips a track to disk and prefers the local copy next time. Planes and bad Wi-Fi are supported. |
| Link importing | Ctrl+L accepts a YouTube/SoundCloud track or playlist, or a remote .m3u. Paste and go. |
| Radio autoplay | Ctrl+T seeds a never-ending station from the current track so the silence never wins. |
| Spotify-style recommendations, locally | Implicit feedback, a co-listening graph, time-of-day context, bandit exploration, content scoring and a slop filter — all in one taste.json. No account, no server. |
→ The other 20+, screenshots of the layout and the fine print: docs/FEATURES.md
🎧 The radio has a taste model
Autoplay is not "search the artist again". MFE keeps a local profile and runs a layered recommender over it — the same shape as Spotify's stack, sized for one machine:
| Stage | What it does here |
|---|---|
| Implicit feedback | Plays, completions, likes, repeats and early skips become continuous rewards (a 92% listen beats a 51% one). |
| Content | Genre/plugin tags and title tokens, scored by cosine against your long-term profile. |
| Behaviour | A track/artist co-listening graph built from consecutive plays. The local stand-in for collaborative filtering. |
| Context | A CoSeRNN-style time bucket (early morning → night, weekday/weekend) learns that 9am and 1am are different people. |
| Logistic model | Online SGD over tag/artist/context features — the single-user shape of Logistic MF. |
| Bandit | Beta-Bernoulli arms per genre with Thompson-style sampling and epsilon-greedy exploration (the BaRT idea). |
| Ordering | Shuffle generates three sequences and keeps the one that spaces artists ~25% apart and pushes recent tracks back. |
| Quality | Slowed/sped-up/nightcore/8D/AI-cover re-uploads are kept out of autoplay. |
|
Everything is in ~/.config/mfe-player/taste.json. No account, no upload, no
listening history leaving the machine. The honest limits (no other users, no
audio CNN, no web NLP) are spelled out in
docs/RECOMMENDATIONS.md.
🍚 Built to live in a rice
MFE is the music player your Hyprland / yabai / GlazeWM setup was missing:
- Transparency that actually works —
Alt+Whands every background cell (base, panels, popups) back to your terminal, so kitty/Ghostty/WezTerm/Windows Terminal opacity and blur show the wallpaper. Works on Linux, macOS and Windows. - 60 fps in-process visualiser — mel-spaced bands, asymmetric spring attack/release, peak hold, beat pulse and 1/8-cell block bars.
cavaonly captures (PipeWire/PulseAudio, CoreAudio incl. the macOS 14.2+ output tap, WASAPI), so the spectrum finally moves with the frame rate instead of the poll timer. - Hide it when you want wallpaper only —
Alt+Sremoves the spectrum panel from the layout with no empty gutter. cava keeps running, so borders and gradients still pulse with the kick. - A palette for every rice —
catppuccin(+catppuccin-latte),everforest,one-dark,tokyo-night,gruvbox,nord,dracula,kanagawa,rose-pine, andwallpaper, which samples the image your compositor is actually showing.Alt+Tcycles. - Mini spectrum in your bar —
mfe status --jsonnow carriesspectrum,pulseandenergy;contrib/mfe-spectrum.shrenders it as▁▂▃▄▅▆▇█for waybar, sketchybar, polybar or YASB without spawning a second cava. - Recipes per desktop — docs/RICING.md has copy-paste configs for Hyprland + waybar, macOS + sketchybar, and the Windows stack (GlazeWM/Komorebi + YASB + Rainmeter + Windows Terminal).
📺 What it looks like
┌ library ──────┐ ┌ ⌕ search · iTunes Search ────────────────────┐ ┌ inspect ───────┐
│ 1 ⌕ search 30 │ │ ⌕ daft punk▌ Enter search/play │ │ Get Lucky │
│ 2 ≡ queue 4 │ │ ─────────────────────────────────────────── │ │ Daft Punk │
│ 3 ★ favorites │ │ ▶ Get Lucky — Daft Punk 4:08 │ │ Random Access… │
│ 4 ▤ playlists │ │ Instant Crush — Daft Punk 5:37 │ │ ★ favorite │
│ 5 ⤓ downloads │ │ Lose Yourself to Dance 5:53 │ │ y lyrics │
│ 6 ⚙ plugins │ │ One More Time — Daft Punk 5:20 │ │ d download │
└───────────────┘ └─────────────────────────────────────────────┘ └────────────────┘
│ ▶ Get Lucky Daft Punk 2:13 / 4:08 vol 70% repeat all │
└ / search · Enter play · a queue · F favorite · P playlist · ? help · Ctrl+P palette ┘
Terminal font does the rest. It looks even better with a real cava panel on the right.
📚 The rest of the manual
Everything longer than a tweet lives in docs/:
| Doc | What's in it |
|---|---|
| Install | every install channel, platforms, Docker, first steps |
| Keys | every hotkey, the full map |
| Daemon | background playback and the CLI verbs that drive it |
| Scripting | waybar/polybar/tmux JSON, one-liners |
| Ricing | Hyprland/waybar, macOS/sketchybar, GlazeWM/YASB, status-spectrum |
| Recommendations | the local Spotify-style stack, how to read and steer it |
| Themes | 17 built-ins, wallpaper palettes, transparency |
| Plugins | the Python JSON contract, bundled providers |
| Architecture | how the pieces talk to each other |
| Features | the complete feature table |
| Config | every config.toml key and where files live |
📄 License
MIT. Do what you want with it — the license text is in LICENSE. No pressure either way, honestly.
🤝 Contributing
- Fork it.
cargo build --release- Break something.
- Fix it better than I would have.
- Open a PR with a screenshot and a one-line reason.
Read CONTRIBUTING.md for the boring-but-useful details. Bug reports with the output of mfe status, your distro and mpv --version get fixed about 10× faster.
If MFE saves you money, time or one browser tab: drop a star. Stars are how other devs find the thing, and how I know someone besides me is using it.
Built because renting music is a weird business model.
MIT licensed. No ads. No trackers. No "upgrade to continue".
⭐ Star the repo · 🐛 Report a bug · 💡 Request a feature