Stars
Forks
Watchers
Developer links
Polaris
Whether your personal audio library spans ten thousand lossless FLAC albums or a sprawling hierarchy of studio recordings, Polaris streams your entire music collection to any browser or mobile device with instant responsiveness. You can browse cataloged tracks by album, artist, genre, or raw directory tree without waiting for sluggish page loads. Multi-value metadata indexing cleanly separates collaborations across artists, composers, record labels, and lyricists. A structured query bar filters songs using per-field search operators and boolean combinators. During playback, real-time audio waveform visualizations render signal peaks directly inside the scrubbing bar. Lossless and compressed formats play seamlessly, covering FLAC, MP3, MP4, M4B, Ogg Vorbis, Opus, Musepack, APE, WAV, and AIFF files. Each household listener gets an isolated account with private playlists, dark mode themes, and customizable color palettes. Administrators can edit mount points, user credentials, and dynamic DNS hooks either through the web settings panel or a plain-text configuration file. Mobile listeners can also connect from dedicated Android and iOS companion apps on the go. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT licensed.
Benefits
- Engineered for Massive Music Libraries
- Indexes and serves collections exceeding 100,000 audio tracks with low-memory Rust concurrency, gzip-compressed API payloads, and automatic filesystem scan triggers whenever albums are added or modified.
- Rich Multi-Value Metadata Indexing
- Parses multi-value tags across artist, album artist, composer, genre, record label, and lyricist fields, while preserving direct folder-tree navigation for uncurated or bootleg directories.
- Interactive Audio Waveform Playback
- Extracts signal peak data on the server to render visual audio waveforms in the web player alongside queue management, random album discovery, and customizable dark color palettes.
- Dual Web and Plain-Text Configuration
- Stores library mount points, user accounts, and dynamic DNS settings in a clean TOML configuration file that administrators can modify either in a text editor or via the web UI.
Features
- Multi-Format Audio Streaming
- Streams FLAC, MP3, MP4, M4B, Musepack, Ogg Vorbis, Opus, Monkey's Audio APE, WAV, and AIFF files directly to browsers and native mobile clients.
- Structured Per-Field Search
- Executes fast search queries across track titles, albums, artists, and labels using per-field syntax and boolean combinators through the REST search endpoint.
- Audio Signal Peak Extraction
- Computes track amplitude envelopes via the dedicated peaks API endpoint to display interactive waveform progress bars during browser playback.
- Multi-User Playlist Management
- Supports multiple user accounts authenticated via bearer tokens, allowing each listener to create, import, and persist independent song queues and playlists.
- Built-In OpenAPI Documentation
- Distributes interactive Swagger and OpenAPI v8 specification docs at the local api-docs endpoint for integrating custom desktop or mobile streaming clients.