Helix
Self-hosted music player with Pandora-style stations, shared listening lobbies, and playlist imports, built on a Subsonic-compatible library.
Open source alternative to:





Helix is a self-hosted music player, discovery tool, and shared listening system built on top of a Subsonic-compatible music library such as Navidrome. It is aimed at people who already run their own music server but want a more modern listening experience: full search, queues, playlists, generated radio stations, and shared listening sessions in one web interface. The software is early-stage, so expect rough edges, breaking changes, and some setup work.
The discovery features are modeled on listening radio. You can generate stations from artists, artist collections, or tags, and tune each station with settings like artist variety, discovery level, tag strictness, and repeat avoidance. Stations automatically keep filling the queue ahead of playback, similar to how Pandora builds an endless personalized stream. Helix can also import playlists from Spotify, YouTube Music, and Pandora — imports are previewed first, matched against playable music, and you approve each track before anything is added.
Beyond listening, Helix adds a fulfillment workflow: when a track is not in your library, you can request it, and Helix stages the download, repairs metadata via beets, and then imports it into your Subsonic library. Optional slskd/Soulseek integration asynchronously replaces Helix-added tracks with higher-quality copies, including lossless upgrades. Shared lobbies let multiple listeners join a synchronized queue with a five-letter code and optional password, and an optional companion bot mirrors a lobby into a Discord voice channel. A native Android client is also available for mobile playback and control.
Compared to Spotify or Pandora, the trade is control for convenience: you supply and store the music yourself, there is no subscription and no advertising, and recommendations come from your own library and optional ListenBrainz integration rather than a commercial catalog. There is no bundled store or licensed catalog — for music you cannot fulfill yourself, you still play from your existing sources or resolved playlist imports.
Categories:
Build with:
Frequently Asked Questions
Which platforms does Helix run on?
Helix runs as a self-hosted web application, distributed as a Docker image (ghcr.io/unifiedkings/helix). There is an optional native Android client, Helix for Android, available as APK releases that connects to your Helix server and mirrors its playback state and queue. An optional companion project, HelixBot, can also mirror a listening lobby into a Discord voice channel.
What authentication options does Helix support?
Helix ships local username and password accounts by default. It can optionally use authentik as an OpenID Connect identity provider for single sign-on, while keeping local login available as a fallback; new OIDC users can be created automatically. Shared listening lobbies have an optional password on top of their five-letter join code.
Can I import existing playlists into Helix?
Yes. Helix can import playlists from Spotify (via an Exportify CSV export), YouTube Music (a share link for regular playlists, or a saved HTML file for Liked Music), Pandora (public playlist links, no login required), and from other Helix instances as JSON. Every import goes through a preview step where tracks are matched, classified as matched, needs review, or unmatched, and you pick exactly which tracks to add.
Does Helix work with Navidrome or other Subsonic servers?
Helix is built around the Subsonic API, so it works with any Subsonic-compatible server such as Navidrome or Airsonic. The connection is configured in docker-compose environment variables or the settings UI, and Helix degrades gracefully: features that require a Subsonic server are hidden or disabled when none is configured, so you can still use search, queues, and playlist imports from resolved YouTube sources.
Does Helix have an API or extension system?
Helix exposes an HTTP API and ships with OpenAPI documentation that can be enabled by setting HELIX_ENABLE_API_DOCS=true. Station generation is extensible through custom station providers written as Python plugins, placed in a plugins directory and enabled via environment variables.
OpenAltFinder Score
Project Details
Repository details
Updated 10/12/2026, 12:00:14 AM
View RepositoryRepository activity
Compare Helix with
Similar open source alternatives

Sunoh
Android music app that plays YouTube Music, Gaana and Saavn plus your local files through one ad-free interface.
SpotifyAurral
Open-source self-hosted music discovery and playlist companion for Lidarr with personalised recommendations, playlist automation, and multi-user support.
Spotifypodgrab
A self-hosted podcast manager/downloader/archiver tool to download podcast episodes as soon as they become live with an integrated player.
Apple Podcasts
DroppedNeedle
Self-hosted music request and discovery server that drives your own download clients, verifies every file, and shelves it in a library you own.
Spotify
Yuzic
A free, open-source cross-platform music player for Navidrome, Jellyfin, Plex and other Subsonic-compatible servers.
Spotify
Noctis
Cross-platform lossless music player with rich library management, synced lyrics, and gapless playback for Windows, macOS, and Linux.
Spotify




