How jeffvli/feishin works
Feishin is a self-hosted music client for Jellyfin, Navidrome, and Subsonic servers, packaged as a desktop app and also offered as a web client. The typical workflow is to connect to a music server, browse its library, and play music through a selected player backend; lyrics, playlists, and a phone-friendly remote are additional capabilities. The graph combines README-documented product flows with source-index relationships and shown IPC/API calls. Some feature wiring is unsampled, so uncertain links are omitted or dashed.
Main entry points: app.tsx Desktop renderer · audio-player Player controls · main/index.ts Desktop process · preload/index.ts Preload bridge
Components 21
Client experience
- Desktop renderer
src/renderer/app.tsx - Web client
src/remote/app.tsx - Server connection
src/renderer/features/action-required
Music library
- Server API adapters
src/renderer/api - Albums
src/renderer/features/albums - Artists
src/renderer/features/artists - Playlists
src/renderer/features/playlists - Lyrics
src/renderer/features/lyrics
Playback and desktop
- Player controls
src/renderer/features/player/audio-player - Web player
src/renderer/features/player/audio-player/engine/web-player-engine.tsx - MPV player
src/renderer/features/player/audio-player/engine/mpv-player-engine.tsx - DLNA player
src/renderer/features/player/audio-player/engine/dlna-player-engine.tsx - Preload bridge
src/preload/index.ts - Desktop process
src/main/index.ts - Settings and secrets
src/main/features/core/settings/index.ts - Media keys
src/main/features/core/player/media-keys.ts
Remote access
- Remote interface
src/remote/components/remote-container.tsx - Remote service
src/main/features/core/remote/index.ts - Remote IPC bridge
src/preload/remote.ts
Other components
- Listener
- Music server
Connections 23
- Listener → Desktop renderer: uses
README.md - Listener → Web client: uses
README.md - Desktop renderer → Server connection: configures
- Server connection → Server API adapters: selects server
- Server API adapters → Music server: requests library
README.md - Desktop renderer → Albums: browses
- Desktop renderer → Artists: browses
- Desktop renderer → Playlists: edits playlists
README.md - Desktop renderer → Lyrics: shows lyrics
README.md - Desktop renderer → Player controls: controls playback
- Player controls → Web player: selects backend
README.md - Player controls → MPV player: selects backend
README.md - Player controls → DLNA player: selects device
src/renderer/features/player/audio-player/engine/dlna-player-engine.tsx - MPV player → Preload bridge: uses bridge
- DLNA player → Preload bridge: uses bridge
- Desktop process → Preload bridge: configures preload
src/main/index.ts - Desktop process → Settings and secrets: initializes
src/main/index.ts - Desktop process → Media keys: imports feature
src/main/index.ts - Media keys → Settings and secrets: reads preferences
src/main/features/core/player/media-keys.ts - Web client → Remote interface: renders
- Remote interface → Remote IPC bridge: sends requests
- Remote IPC bridge → Remote service: IPC requests
src/preload/remote.ts - Remote service → Music server: proxies requests