README.md

Polaris is a music streaming application, designed to let you enjoy your music collection from any computer or mobile device. Polaris works by streaming your music directly from your own computer, without uploading it to a third-party. It is free and open-source software, without any kind of premium version. The only requirement is that your computer stays on while it streams music!

Features

• Optimized for large music collections
• Can run on Windows, Linux, BSD, or through Docker
• Listen to your music on the web or using the Polaris Android app
• Easy to setup and configure via the built-in web UI
• Support for flac, mp3, mp4, mpc, ogg and opus files
• Support for album art images
• Last.fm scrobbling
• Color themes
• Restrict access to your music collection with user accounts

Tutorials

• Getting Started
• Streaming From Remote Devices

Screenshots

Documentation

• Contribute to Polaris
• Maintenance Runbooks

API Documentation

The Polaris server API is documented via Swagger. Please note that this Swagger page does not point to a live Polaris server so the Try it out buttons are not expected to work. Every installation of Polaris also distributes this documentation, with the ability to use the Try it out buttons. To access it, simply open http://localhost:5050/swagger/ in your browser on the machine running Polaris.

Feel free to open Github issues or Pull Requests if clarifications are needed.