polaris/README.md

37 lines
2 KiB
Markdown
Raw Normal View History

2019-09-29 07:09:44 +00:00
[![Actions Status](https://github.com/agersant/polaris/workflows/Build/badge.svg)](https://github.com/agersant/polaris/actions)
2016-09-15 06:46:39 +00:00
2016-12-01 05:30:37 +00:00
<img src="res/readme/logo.png?raw=true"/>
2016-11-29 07:23:09 +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 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!
2016-09-26 03:05:09 +00:00
## Key Features
- Optimized for large music collections
- Can run on Windows, Linux and BSD or through Docker
- Listen to your music through on the web or using the [Polaris Android](https://github.com/agersant/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](https://www.last.fm) scrobbling
- Color themes
- Restrict access to your music collection with user accounts
2016-09-26 03:05:09 +00:00
## Tutorials
2016-09-26 03:05:09 +00:00
2020-08-27 08:42:52 +00:00
- [Getting Started](https://agersant.github.io/polaris/SETUP)
- [Streaming From Remote Devices](https://agersant.github.io/polaris/DDNS)
2016-09-26 03:12:59 +00:00
## Screenshots
2016-09-26 03:05:09 +00:00
![Polaris Web UI](res/readme/web_ui.png?raw=true "Polaris Web UI")
![Polaris Web UI Dark Mode](res/readme/dark_mode.png?raw=true "Polaris Web UI")
2016-09-26 03:05:09 +00:00
## Documentation
2019-04-08 00:52:38 +00:00
2020-08-27 08:42:52 +00:00
- [Contribute to Polaris](https://agersant.github.io/polaris/CONTRIBUTE)
- [Maintenance Runbooks](https://agersant.github.io/polaris/MAINTENANCE)
2019-04-08 00:52:38 +00:00
### API Documentation
The Polaris server API is documented via [Swagger](https://agersant.github.io/polaris/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.
2019-04-10 06:51:47 +00:00
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.
2019-04-08 02:23:02 +00:00
Feel free to open Github issues or Pull Requests if clarifications are needed.