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
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+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. |
→ 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
- 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
Metadata
Release files for mfe-player 0.3.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| mfe_player-0.3.6-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details for mfe_player-0.3.6-py3-none-win_amd64.whl |
| mfe_player-0.3.6-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details for mfe_player-0.3.6-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
| mfe_player-0.3.6-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details for mfe_player-0.3.6-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
| mfe_player-0.3.6-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details for mfe_player-0.3.6-py3-none-macosx_11_0_arm64.whl |
| mfe_player-0.3.6-py3-none-macosx_10_12_x86_64.whl | Python 3 | none | macOS 10.12+ x86-64 | Details for mfe_player-0.3.6-py3-none-macosx_10_12_x86_64.whl |
Total release size: 10.9 MB
Release files / mfe_player-0.3.6-py3-none-win_amd64.whl
| Download URL | mfe_player-0.3.6-py3-none-win_amd64.whl |
|---|---|
| Size | 2.0 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
07556dfcd683f9b6b6ebe052dfe3f8569dcd086dbe7acc065b2d2f246817895e
|
|
BLAKE2b-256 checksum How to use checksums |
116091abbf3dd7d0dbdb6133a7adff54b2d9a5a0020f2f6bfb0dd335cafd9ab2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.16.0
|
Release files / mfe_player-0.3.6-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | mfe_player-0.3.6-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
3560d07813ac58a2da05b70ffdb14b1106180aa0dce4428fb8f7032eff0f0eae
|
|
BLAKE2b-256 checksum How to use checksums |
57cafe81aa2e5b3f1e4d5834d85c52c189c439bf6d8e0749fa96dec3ab077a4a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.16.0
|
Release files / mfe_player-0.3.6-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | mfe_player-0.3.6-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
518c1c900a60065f8c86cbb36165cf9d545e0d9ca2ecf787f1460270a0a2f9d8
|
|
BLAKE2b-256 checksum How to use checksums |
7ff5ac5cb947ea69e1bfbb90b306b52ddb755473cb37fdb1a0fa4881db67dd36
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.16.0
|
Release files / mfe_player-0.3.6-py3-none-macosx_11_0_arm64.whl
| Download URL | mfe_player-0.3.6-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.8 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f7be7d347817594d75ac0ab61aff2f0a53b8773f53618bb2b9f84b8a15a9050d
|
|
BLAKE2b-256 checksum How to use checksums |
ba226d83c47962c5c6ab2e205a5cf08ed8cebde7bae1e5b251f57889ece92fbb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.16.0
|
Release files / mfe_player-0.3.6-py3-none-macosx_10_12_x86_64.whl
| Download URL | mfe_player-0.3.6-py3-none-macosx_10_12_x86_64.whl |
|---|---|
| Size | 1.9 MB |
| Tags | Python 3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
f02cc6ed7c0efee31534e29e39f1c10976b7edec6c5dd8694ba4539fd7df49a8
|
|
BLAKE2b-256 checksum How to use checksums |
3d117c7142a7de6cb72d6f865d1cb791659f5edf58e60cb0f8b65641dad8bf5b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.16.0
|
Security for mfe-player 0.3.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.