feishin
Feishin is a modern, self-hosted music player written in TypeScript that works with Subsonic-compatible servers (Navidrome, Jellyfin). It offers both desktop (with MPV backend) and web clients, with active development, a growing user base (~9k stars), and a permissive GPL-3.0 license.
Key facts
Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.
| Field | Value |
|---|---|
| Repository | jeffvli/feishin |
| Owner | jeffvli |
| Primary language | TypeScript |
| License | GPL-3.0 — OSI-approved |
| Stars | 9k |
| Forks | 461 |
| Open issues | 211 |
| Latest release | v1.13.0 (2026-06-03) |
| Last updated | 2026-07-08 |
| Source | https://github.com/jeffvli/feishin |
What feishin is
TypeScript-based Electron desktop app and web UI supporting Subsonic API protocol, featuring dual player backends (MPV for desktop, Web player for browser), scrobbling, smart playlist editing (Navidrome), and synchronized/unsynchronized lyrics. Uses Docker containerization and modern frontend tooling.
Get the feishin source
Clone the repository and explore it locally.
git clone https://github.com/jeffvli/feishin.gitcd feishin# follow the project's README for install & configurationNeed it deployed, integrated, or customized instead? DEV.co ships production installs.
Best use cases
Implementation considerations
- Requires MPV binary on desktop clients; ensure version 0.35.x or 0.36.x compatibility and proper system PATH configuration.
- Desktop app requests macOS Accessibility Client trust and Electron quarantine removal on newer macOS versions; plan for user onboarding.
- Docker deployment uses `ghcr.io` registry; confirm firewall/registry access and use port 9180 or restrict to localhost per deployment topology.
- Password storage uses libsecret (Linux) or system keychain; verify secret store compatibility if deploying across heterogeneous OS.
- Web player backend lacks some desktop features (e.g., lyrics fetching); set expectations for feature parity by platform.
When to avoid it — and what to weigh
- Requires Commercial License — GPL-3.0 is a copyleft license; any modifications or derivative work must remain open-source. If proprietary redistribution is needed, consult legal counsel or seek an alternative license.
- No Native Streaming Service Integration — Feishin only works with self-hosted music servers (Subsonic-compatible). It does not support Spotify, Apple Music, YouTube Music, or similar commercial streaming.
- Dependence on External Server — Feishin is a client only; you must operate and maintain a Navidrome, Jellyfin, or Subsonic instance. It cannot function standalone.
- Limited Enterprise/Support Guarantees — Community-driven open-source project; no commercial SLA, paid support tier, or guaranteed response times for critical issues.
License & commercial use
GPL-3.0 (GNU General Public License v3.0). This is a copyleft license requiring any modified source code or derivative works to be distributed under the same terms and remain open-source.
Caution required. GPL-3.0 permits internal use and deployment without redistribution. However, if you modify Feishin or incorporate it into a distributed product (commercial or otherwise), you must release source code under GPL-3.0 and provide access to end-users. Consult legal counsel before using in proprietary products. No explicit commercial license or dual-licensing arrangement is documented.
DEV.co evaluation signals
Editorial assessment — not user reviews. Directional, with an explicit confidence level.
| Signal | Assessment |
|---|---|
| Maintenance | Active |
| Documentation | Adequate |
| License clarity | Clear |
| Deployment complexity | Low |
| DEV.co fit | Good |
| Assessment confidence | High |
Feishin inherits security posture from the Subsonic server it connects to (no independent auth layer). Desktop app requests accessibility permissions (macOS) and manages passwords via system keychain/libsecret; review OS-level trust model. Web client (https://feishin.vercel.app) uses third-party hosting; for sensitive deployments, self-host only. No published security policy or CVE history available in provided data; audit code and dependencies if deploying in regulated environments.
Alternatives to consider
Navidrome built-in web UI
Native to Navidrome; simpler setup, tighter integration, no external client needed—trade-off is fewer UI refinements and features vs. Feishin.
Subsonic/OpenSubsonic native Android app
Official client for Subsonic-compatible servers; mature, supported, fewer platform dependencies—limited to mobile, may lack desktop experience.
Airsonic-Advanced web player
Fork of Airsonic with updated web UI; self-hosted, Subsonic-compatible—smaller community, slower feature velocity than Feishin.
Build on feishin with DEV.co software developers
Feishin is a solid choice for teams building or integrating with Subsonic-compatible music infrastructure. Verify GPL-3.0 compliance, plan MPV/Docker setup, and engage the community on Discord for implementation guidance.
Talk to DEV.coRelated open-source tools
Surfaced by semantic similarity across the DEV.co open-source index.
Related on DEV.co
Explore the category and the services that help you build with it.
feishin FAQ
Can I use Feishin with Spotify or Apple Music?
Do I need MPV installed?
Is there a commercial license or paid support?
Can I modify and redistribute Feishin?
Software development & web development with DEV.co
Adopting feishin is usually one piece of a larger software development effort. As a software development agency, DEV.co provides software development services and web development expertise — pairing senior software developers and web developers with your team to design, build, and operate open-source devops software in production.
Ready to Deploy a Self-Hosted Music Client?
Feishin is a solid choice for teams building or integrating with Subsonic-compatible music infrastructure. Verify GPL-3.0 compliance, plan MPV/Docker setup, and engage the community on Discord for implementation guidance.