# Feishin

Feishin is a modern self-hosted music player and a rewrite of Sonixd that plays your local library through a web or MPV-based player, with lyrics, scrobbling, and a smart playlist editor. It is open source and self-hosted, installable on Unraid, Proxmox and Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/2791/feishin

## Description

Feishin is a modern self-hosted music player and a rewrite of Sonixd that plays your local library through a web or MPV-based player, with lyrics, scrobbling, and a smart playlist editor.

## Platform availability

Available on 5 of 10 platforms: Unraid, Proxmox, Helm, Mac, Linux.

## Desktop and other devices

Mac, Linux.

## Health score

82/100 (Excellent), based on 5 of 5 factors.
- Maintained: 100 (last commit 10 days ago)
- Popular: 80 (10,417 GitHub stars)
- Easy to install: 75 (5 install platforms, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)
- Security check: 78 (no serious findings, 2 minor, CI)

## Links

- GitHub: https://github.com/jeffvli/feishin
- desktop: https://github.com/jeffvli/feishin/releases/latest
- Official website: https://feishin.vercel.app/
- Unraid: https://ca.unraid.net/apps/feishin-0gzv98s133tc94?q=Feishin
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=feishin
- Kubernetes (Helm): https://artifacthub.io/packages/helm/kubernetes-homelab-helm-charts/feishin

## Common questions

### Is the Feishin desktop client recommended?

Yes, the desktop client is the recommended way to use Feishin. It supports both the MPV and web player backends and includes built-in lyrics fetching.

### How do I install Feishin on Linux?

Install it from Flathub or use the provided AppImage install script. Native Wayland mode is experimental and not officially supported.

### What macOS setup gotchas does Feishin have?

On macOS 12 or newer, the app may need to be removed from quarantine. For media keys, allow Feishin as a Trusted Accessibility Client and restart it.

### Can I run Feishin with Docker?

Feishin is available as a Docker image. The web client only supports the web player backend.

### Does Feishin slow down the system?

A user reports system slowdowns when using Feishin, especially during song changes. The discussion says the issue improved but remained uncomfortable.

## Alternatives

- Finamp: Finamp is a Jellyfin music player.
- Jellyfin: Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media.
- Psysonic: Psysonic is a fast, native, open-source desktop music client for self-hosted music libraries.

---
Source: Our Local Host (https://ourlocalhost.com/app/2791/feishin), the self-hosted and open-source app directory.
