mfe-player 0.3.6

Music For Everyone — a plugin-driven, terminal-native music player that tells subscriptions to get lost
mfe-player-0.3.6 is not a library.

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.

CI Release Stars License: MIT Rust crates.io npm

The rant · Features · Install · Keys · Daemon · Themes

curl -fsSL https://raw.githubusercontent.com/omkargs/mfe-player/master/install.sh | bash

Not a curl | bash person? Every channel installs the same binary:

cargo install mfe-player        # Rust package registry, prebuilt via cargo-binstall too
npm install -g mfe-player       # esbuild-style per-platform packages, no postinstall script
pipx install mfe-player         # PyPI wheels via maturin (uv tool install mfe-player)

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+B background playback keeps playing untouched; pressing Enter on a paused player restarts it from the beginning.)
  • radio = false in 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 now mfe-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.

→ The other 20+, screenshots of the layout and the fine print: docs/FEATURES.md


📺 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
Themes 14 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

  1. Fork it.
  2. cargo build --release
  3. Break something.
  4. Fix it better than I would have.
  5. 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