- Adds project goals

- Updates feature list
- Readme polish
This commit is contained in:
Antoine Gersant 2025-02-02 00:49:59 -08:00
parent 87c4bdc247
commit cf5d1b7931

View file

@ -1,48 +1,64 @@
[![Actions Status](https://github.com/agersant/polaris/workflows/Build/badge.svg)](https://github.com/agersant/polaris/actions) <div align="center">
[![codecov](https://codecov.io/github/agersant/polaris/graph/badge.svg?token=EQqCmBEf2T)](https://codecov.io/github/agersant/polaris) <h1><img src="res/readme/logo.png?raw=true"/></h1>
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE-MIT)
<img src="res/readme/logo.png?raw=true"/> [![Actions Status](https://github.com/agersant/polaris/workflows/Build/badge.svg)](https://github.com/agersant/polaris/actions)
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. [![codecov](https://codecov.io/github/agersant/polaris/graph/badge.svg?token=EQqCmBEf2T)](https://codecov.io/github/agersant/polaris)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE-MIT)
## Try It Out! ![Polaris Web UI](res/readme/web_ui.png?raw=true "Polaris Web UI")
</div>
# About
Polaris is a self-hosted music streaming server, to enjoy your music collection from any computer or mobile device. It is free and open-source software, without any kind of premium version.
The goals of this project are:
- 🔥 Exceptional performance and responsiveness
- 📚️ First-class support for large music collections (100,000+ songs)
- 📦️ Ease of installation, deployment and maintenance
- ✨ Beautiful user interface
# 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: 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` Username: `demo_user`
Password: `demo_password` Password: `demo_password`
## Features # Features
![Polaris Web UI](res/readme/web_ui.png?raw=true "Polaris Web UI") - 🖥️ Runs on Windows, Linux, BSD, or through Docker
- 🔊 Support for `flac`, `mp3`, `mp4`, `mpc`, `ogg`, `opus`, `ape`, `wav` and `aiff` files
- Optimized for large music collections - 🌈 Dark mode variants and customizable color palette
- Can run on Windows, Linux, BSD, or through Docker - 💿️ Browse your music by album, artist or genre
- Support for `flac`, `mp3`, `mp4`, `mpc`, `ogg`, `opus`, `ape`, `wav` and `aiff` files - 📂 Browse your music as a file tree
- Easy to setup and administer, no configuration files required - 🌊 Song audio-waveform visualization
- Dark mode and customizable color themes - 🏷️ Support for multi-value fields in song metadata (eg. multiple artists per song)
- Listen to your music on the go: - 🔍️ Powerful search functionality with per-field queries
- ⚙️ Plain-text configuration also editable with built-in UI
- 👥 Setup multiple users, each with their own playlists
- 📱 Listen to your music on the go:
- Polaris Android ([Google Play Store](https://play.google.com/store/apps/details?id=agersant.polaris) · [F-Droid](https://f-droid.org/packages/agersant.polaris/) · [Repository](https://github.com/agersant/polaris-android)) - Polaris Android ([Google Play Store](https://play.google.com/store/apps/details?id=agersant.polaris) · [F-Droid](https://f-droid.org/packages/agersant.polaris/) · [Repository](https://github.com/agersant/polaris-android))
- Polarios ([App Store](https://apps.apple.com/app/polarios/id1662366309) · [Repository](https://gitlab.com/elise/Polarios)) - Polarios ([App Store](https://apps.apple.com/app/polarios/id1662366309) · [Repository](https://gitlab.com/elise/Polarios)) [third-party]
- [Last.fm](https://www.last.fm) scrobbling
## Setup Guide # Installation
- [Installation](docs/SETUP.md) [Installation documentation](docs/SETUP.md)
- [Streaming From Remote Devices](docs/DDNS.md)
## Documentation [Streaming from remote devices](docs/DDNS.md)
- [Changelog](CHANGELOG.md) [![Packaging status](https://repology.org/badge/vertical-allrepos/polaris-streaming.svg)](https://repology.org/project/polaris-streaming/versions)
- [Configuration](docs/CONFIGURATION.md)
- [Contribute to Polaris](docs/CONTRIBUTING.md)
- [Maintenance Runbooks](docs/MAINTENANCE.md)
### API Documentation # Documentation
- 📒 [Changelog](CHANGELOG.md)
- 🔧 [Configuration](docs/CONFIGURATION.md)
- 👷 [Contribute to Polaris](docs/CONTRIBUTING.md)
- 🛟 [Maintenance Runbooks](docs/MAINTENANCE.md)
The Polaris server API is documented via [OpenAPI](https://demo.polaris.stream/api-docs/). Every installation of Polaris distributes this interactive documentation. To access it, simply open http://localhost:5050/api-docs/ in your browser on the machine running Polaris. The Polaris server API is documented via [OpenAPI](https://demo.polaris.stream/api-docs/). Every installation of Polaris distributes this interactive documentation. To access it, simply open http://localhost:5050/api-docs/ in your browser on the machine running Polaris.
## Credits & License Information # Credits & License Information
Music featured in the demo installation: Music featured in the demo installation: