Feishin: A Modern, Self-Hosted Music Player for Your Personal Library

Remember when you owned your music? Not just a streaming subscription, but actual files—MP3s, FLACs, whole albums you carefully curated. In the age of streaming, managing a personal music library can feel like a forgotten art. But what if you could have a sleek, modern music player for that library, one you host yourself and fully control? That’s exactly what Feishin is for.

It’s a self-hosted music streaming server and web client that looks and feels like a contemporary streaming service, but it’s powered entirely by your own collection. Think of it as giving your old music library a serious, beautiful upgrade.

What It Does

Feishin is a web-based music player application. You run it as a server on your own machine (or home server), point it to your folder of music files, and it handles the rest. It scans your library, organizes albums and artists, fetches metadata and album art, and provides you with a clean, responsive interface to stream your music from any device on your network—or even over the internet if you set it up that way.

Why It's Cool

The magic of Feishin is in its balance of polish and principle. It doesn’t try to be a heavyweight media server with features for movies and TV; it’s laser-focused on being a great music player.

• It’s Familiar, Not Foreign: The interface will feel instantly comfortable to anyone who uses Spotify, Apple Music, or similar services. You get a "Now Playing" view, queue management, playlists, and library browsing that works the way you expect.
• Subsonic API Compatible: This is a huge win for audiophiles and tinkerers. Feishin speaks the Subsonic API, which means it’s compatible with a whole ecosystem of existing mobile apps (like substreamer or play:sub). You can use the Feishin web UI on your desktop and a dedicated mobile app on your phone, all connecting to the same server.
• Multi-User Friendly: Built with the idea that a household might share a music library. It supports multiple user accounts, so everyone can have their own playlists and favorites.
• It Respects Your Data: Your library, your rules. All your music stays local. The metadata it fetches is to enhance your experience, not to sell you anything.

How to Try It

The easiest way to get started is with Docker. If you have Docker installed, getting Feishin running can be as simple as:

docker run -d \
  --name feishin \
  -p 9920:9920 \
  -v /path/to/your/music:/music \
  -v /path/to/config:/config \
  ghcr.io/jeffvli/feishin:latest

Then, open your browser to http://your-server-ip:9920. The initial setup wizard will guide you through scanning your music library.

For more detailed instructions, including Docker Compose examples and non-Docker setups, check out the full documentation on the Feishin GitHub repository.

Final Thoughts

Feishin hits a sweet spot. It’s for the developer or hobbyist who wants the convenience of a modern streaming UI but the permanence and ownership of a local file collection. It’s a weekend project that genuinely improves your daily life. Whether you’re dusting off an old iTunes library, managing a lossless audio collection, or just want to keep your music independent from the whims of streaming services, Feishin is a compelling and well-executed option. It’s the kind of project that reminds you why self-hosting can be so satisfying.

Found this interesting? We share cool projects daily. Follow us at @githubprojects.