Feishin — Modern Self-Hosted Music Player

Introduction

Feishin is a modern music player designed for self-hosted music servers. It connects to Navidrome, Jellyfin, and other Subsonic-compatible backends to provide a polished listening experience with features like gapless playback, synchronized lyrics, and smart playlists across desktop and web platforms.

What Feishin Does

• Connects to Navidrome, Jellyfin, and Subsonic-compatible music servers
• Provides gapless playback with crossfade support for seamless listening
• Displays synchronized and plain-text lyrics from embedded metadata or external sources
• Supports smart playlists with rule-based filtering (genre, year, play count, etc.)
• Offers both a native desktop app (Electron) and a web-based player

Architecture Overview

Feishin is built with React and Electron, communicating with music servers via the Subsonic API or Jellyfin API. Audio playback uses a custom player engine supporting gapless transitions and audio normalization. The app maintains a local cache for album art and metadata to reduce server load and improve responsiveness.

Self-Hosting & Configuration

• Download pre-built binaries for Windows, macOS, or Linux desktop
• Alternatively run the web version via Docker for browser-based access
• Connect to any Navidrome, Jellyfin, or Subsonic-compatible server
• Configure audio output device, crossfade duration, and replay gain
• Supports multiple server connections with quick switching

Key Features

• Gapless playback and crossfade for uninterrupted listening sessions
• Synchronized lyrics display with karaoke-style highlighting
• Scrobbling to Last.fm and ListenBrainz for play tracking
• Keyboard shortcuts and media key support for efficient control
• Customizable themes with dark mode and accent color options

Comparison with Similar Tools

• Navidrome web UI — basic built-in player; Feishin offers richer features and desktop integration
• Plexamp — requires Plex subscription; Feishin works with free Navidrome/Jellyfin
• Sonixd — predecessor project now archived; Feishin is the active successor
• Sublime Music — Linux-only GTK client; Feishin is cross-platform
• Finamp — Jellyfin-only mobile client; Feishin covers desktop and web with multi-server support

FAQ

Q: Which music servers does Feishin support? A: Navidrome, Jellyfin, and any server implementing the Subsonic/OpenSubsonic API.

Q: Does Feishin support offline playback? A: The desktop app can cache tracks for offline listening when configured.

Q: Can I use Feishin on my phone? A: The web version works on mobile browsers. For native mobile apps, Finamp (Jellyfin) or Substreamer (Subsonic) are recommended.

Q: Is there scrobbling support? A: Yes, Feishin supports scrobbling to Last.fm and ListenBrainz directly from the client.

Sources

• https://github.com/jeffvli/feishin
• https://feishin.vercel.app