2020-12-12 23:31:41 +00:00
[](https://github.com/agersant/polaris/actions)
[](http://codecov.io/github/agersant/polaris)
[](LICENSE-MIT)
2016-09-15 06:46:39 +00:00
2016-12-01 05:30:37 +00:00
< img src = "res/readme/logo.png?raw=true" / >
2022-11-14 08:46:14 +00:00
Polaris is a music streaming application, designed to let you enjoy your music collection from any computer or mobile device. Polaris works by streaming music directly from your computer (or cloud server), without uploading it to a third-party. It is free and open-source software, without any kind of premium version.
## Try It Out!
Check out the demo over at https://demo.polaris.stream, featuring a selection of Creative Commons Music. The credentials to access this server are:
Username: `demo_user`
Password: `demo_password`
2016-09-26 03:05:09 +00:00
2020-08-27 09:30:18 +00:00
## Features
2022-11-14 08:46:14 +00:00
2020-08-27 08:39:50 +00:00
- Optimized for large music collections
2020-09-12 06:52:15 +00:00
- Can run on Windows, Linux, BSD, or through Docker
2021-04-28 04:43:28 +00:00
- Support for `flac` , `mp3` , `mp4` , `mpc` , `ogg` , `opus` , `ape` , `wav` and `aiff` files
2022-11-14 08:46:14 +00:00
- Easy to setup and administer, no configuration files needed
- Dark mode and customizable color themes
- Listen to your music on the go with [Polaris Android ](https://github.com/agersant/polaris-android )
2020-08-27 08:39:50 +00:00
- [Last.fm ](https://www.last.fm ) scrobbling
2016-09-26 03:05:09 +00:00
2020-08-27 08:39:50 +00:00
## Tutorials
2016-09-26 03:05:09 +00:00
2020-08-27 09:00:22 +00:00
- [Getting Started ](docs/SETUP.md )
- [Streaming From Remote Devices ](docs/DDNS.md )
2016-09-26 03:12:59 +00:00
2020-08-27 08:39:50 +00:00
## Documentation
2019-04-08 00:52:38 +00:00
2020-08-27 09:01:19 +00:00
- [Contribute to Polaris ](docs/CONTRIBUTING.md )
2020-08-27 09:00:22 +00:00
- [Maintenance Runbooks ](docs/MAINTENANCE.md )
2019-04-08 00:52:38 +00:00
2020-08-27 08:39:50 +00:00
### API Documentation
2019-04-08 02:23:02 +00:00
2022-11-14 08:46:14 +00:00
The Polaris server API is documented via [Swagger ](https://demo.polaris.stream/swagger/ ). Every installation of Polaris 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.
## Credits & License Information
Music featured in the demo installation:
- [Chris Zabriskie - Abandon Babylon ](https://chriszabriskie.bandcamp.com/album/abandon-babylon ) [(License) ](https://creativecommons.org/licenses/by/3.0/ )
- [Chris Zabriskie - Angie's Sunday Service ](https://chriszabriskie.bandcamp.com/album/angies-sunday-service ) [(License) ](https://creativecommons.org/licenses/by/3.0/ )
- [glaciære - pool water blue ](https://steviasphere.bandcamp.com/album/pool-water-blue ) [(License) ](https://creativecommons.org/licenses/by/3.0/ )
- [glaciære - light ripples ](https://steviasphere.bandcamp.com/album/light-ripples ) [(License) ](https://creativecommons.org/licenses/by/3.0/ )
- [Koresma South ](https://koresma.bandcamp.com/album/south ) [(License) ](https://creativecommons.org/licenses/by-nc-sa/3.0/ )
- [Pete Murphy - Essence EP ](https://petemurphy.bandcamp.com/album/falling-down-the-fred-astaires-solo-jazz-piano ) [(License) ](https://creativecommons.org/licenses/by-nc-sa/3.0/ )
- [Rameses B - Essence EP ](https://ramesesb.bandcamp.com/album/essence-ep ) [(License) ](https://creativecommons.org/licenses/by-nc-nd/3.0/ )
