Skip to main content
MFE Player — Music For Everyone MFE Player in action — search, queue, spectrum, lyrics, detach to daemon

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

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)

Table of built distributions (wheels) for mfe-player 0.3.6
File Actions
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.

Release history Release notifications | RSS feed

This release

0.3.6 This release

5 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page