jeffvli

    jeffvli/feishin

    A modern self-hosted music player.

    10.3K stars
    600 forks
    10.3K GitHub watchers
    Updated Nov 6, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Where it stands

    Rank, growth pace and release cadence relative to everything GStars tracks.

    2 releases in the last 90 days, the latest 51 days ago, with 184 contributors on GitHub.

    Use Cases & Benefits

    • A modern self-hosted music player supporting MPV and web player backends with smart playlist and synchronized lyrics features.
    • Enables seamless integration with Navidrome, Jellyfin, and OpenSubsonic-compatible servers for flexible music streaming.
    • Use for building a private music streaming service with advanced playlist management and lyrics support.
    • Use for deploying a cross-platform desktop music player with native MPV backend and web client options.
    • Use for running a containerized music player via Docker or Docker Compose for easy self-hosted deployment.

    Should you depend on it?

    License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.

    License

    GPL 3.0

    Copyleft: distributing software that includes it generally requires releasing your source under the same license.

    Community files

    • README: present
    • Contributing guide: present

    Watch-outs

    • GPL-style copyleft: including it in distributed software generally requires releasing your source under the same license.

    General guidance from repository metadata, not legal advice. How we score

    From the README

    Download the latest desktop client. The desktop client is the recommended way to use Feishin. It supports both the MPV and web player backends, as well as includes built-in fetching for lyrics.

    If you're using a device running macOS 12 (Monterey) or higher, check here for instructions on how to remove the app from quarantine.

    For media keys to work, you will be prompted to allow Feishin to be a Trusted Accessibility Client. After allowing, you will need to restart Feishin for the privacy settings to take effect.

    We provide a small install script to download the latest .AppImage, make it executable, and also download the icons required by Desktop Environments. Finally, it generates a .desktop file to add Feishin to your Application Launcher.

    The script also has an option to add launch arguments to run Feishin in native Wayland mode. Note that this is experimental in Electron and therefore not officially supported. If you want to use it, run this instead:

    It also provides a simple uninstall routine, removing the downloaded files:

    The entry should show up in your Application Launcher immediately. If it does not, simply log out, wait 10 seconds, and log back in. Your Desktop Environment may alternatively provide a way to reload entries.

    Excerpt from the jeffvli/feishin README on GitHub (GPL-3.0 license). © its authors.Read the full README on GitHub

    Daily snapshots

    Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots

    Forks

    600+112

    Open issues

    335+88

    Compared with peers in Self-Hosted

    Fastest-growing repositories GStars tracks in this cohort for the week of Nov 8, by 7-day star growth

    jeffvli/feishin compared with Self-Hosted repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    milind-soni/OpenMausBot20.6K+8.4K75today
    debpalash/VoiceStudio107.3K+7.2K75today
    jub0t/Concat16.5K+2.5K755 days ago
    DuarteSantos8/openGym20.8K+1.7K757 days ago
    superplanehq/superplane9.8K+1.0K7513 days ago
    jeffvli/feishin10.3K—5751 days ago
    Category median20.6K+2.5K75—

    Discover Repositories

    Search across tracked repositories by name or description