navidrome/README.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

66 lines
4.1 KiB
Markdown
Raw Normal View History

2020-01-24 01:44:08 +01:00
# Navidrome Music Streamer
2016-02-25 00:28:23 +01:00
2020-03-28 02:51:24 +01:00
[![Last Release](https://img.shields.io/github/v/release/deluan/navidrome?label=latest&style=flat-square)](https://github.com/deluan/navidrome/releases)
[![Build](https://img.shields.io/github/workflow/status/deluan/navidrome/Build?style=flat-square)](https://github.com/deluan/navidrome/actions)
2020-06-12 20:21:02 +02:00
[![Downloads](https://img.shields.io/github/downloads/deluan/navidrome/total)](https://github.com/deluan/navidrome/releases/latest)
2020-03-28 02:51:24 +01:00
[![Docker Pulls](https://img.shields.io/docker/pulls/deluan/navidrome?style=flat-square)](https://hub.docker.com/r/deluan/navidrome)
[![Dev Chat](https://img.shields.io/discord/671335427726114836?label=chat&style=flat-square)](https://discord.gg/xh7j7yF)
[![Subreddit](https://img.shields.io/reddit/subreddit-subscribers/navidrome?style=flat-square)](https://www.reddit.com/r/navidrome/)
2020-07-21 20:40:21 +02:00
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg)](code_of_conduct.md)
2016-02-26 16:56:57 +01:00
2020-01-24 04:57:51 +01:00
Navidrome is an open source web-based music collection server and streamer. It gives you freedom to listen to your
2020-02-05 14:40:15 +01:00
music collection from any browser or mobile device. It's like your personal Spotify!
2020-01-25 18:35:28 +01:00
2020-01-26 04:01:37 +01:00
__Any feedback is welcome!__ If you need/want a new feature, find a bug or think of any way to improve Navidrome,
please fill a [GitHub issue](https://github.com/deluan/navidrome/issues) or join the discussion in our
[Subreddit](https://www.reddit.com/r/navidrome/). If you want to contribute to the project in any other way
2020-05-03 06:01:33 +02:00
([ui/backend dev](https://www.navidrome.org/docs/developers/),
[translations](https://www.navidrome.org/docs/developers/translations/),
[themes](https://www.navidrome.org/docs/developers/creating-themes)), please join the chat in our
[Discord server](https://discord.gg/xh7j7yF).
2020-01-27 14:04:55 +01:00
2020-07-14 13:59:14 +02:00
## Demo Site
To see Navidrome in action, check out our [live demo](https://www.navidrome.org/demo/)
2020-06-10 17:34:51 +02:00
## Installation
See instructions in the [project's website](https://www.navidrome.org/docs/installation/)
## Features
- Handles very **large music collections**
- Streams virtually **any audio format** available
- Reads and uses all your beautifully curated **metadata**
- Great support for **Box Sets** (multi-disc albums)
- **Multi-user**, each user has their own play counts, playlists, favourites, etc...
- Very **low resource usage**
- **Multi-platform**, runs on macOS, Linux and Windows. **Docker** images are also provided
- Ready to use **Raspberry Pi** binaries and Docker images available
- Automatically **monitors your library** for changes, importing new files and reloading new metadata
- **Themeable**, modern and responsive **Web interface** based on [Material UI](https://material-ui.com)
- **Compatible** with all Subsonic/Madsonic/Airsonic [clients](https://www.navidrome.org/docs/overview/#apps)
- **Transcoding** on the fly. Can be set per user/player. **Opus encoding is supported**
- Translated to **various languages**
2020-05-03 06:01:33 +02:00
## Documentation
2020-06-10 17:34:51 +02:00
All documentation can be found in the project's website: https://www.navidrome.org/docs.
2020-05-03 06:01:33 +02:00
Here are some useful direct links:
2020-01-25 18:35:28 +01:00
2020-05-03 06:01:33 +02:00
- [Overview](https://www.navidrome.org/docs/overview/)
- [Installation](https://www.navidrome.org/docs/installation/)
- [Docker](https://www.navidrome.org/docs/installation/docker/)
- [Binaries](https://www.navidrome.org/docs/installation/pre-built-binaries/)
- [Build from source](https://www.navidrome.org/docs/installation/build-from-source/)
- [Development](https://www.navidrome.org/docs/developers/)
2020-05-06 14:08:43 +02:00
- [Subsonic API Compatibility](https://www.navidrome.org/docs/developers/subsonic-api/)
2020-03-21 12:57:15 +01:00
2020-01-24 04:57:51 +01:00
## Screenshots
2020-05-03 06:01:33 +02:00
<p align="left">
<img height="550" src="https://raw.githubusercontent.com/deluan/navidrome/master/.github/screenshots/ss-mobile-login.png">
<img height="550" src="https://raw.githubusercontent.com/deluan/navidrome/master/.github/screenshots/ss-mobile-player.png">
<img height="550" src="https://raw.githubusercontent.com/deluan/navidrome/master/.github/screenshots/ss-mobile-album-view.png">
2020-05-04 01:25:39 +02:00
<img width="550" src="https://raw.githubusercontent.com/deluan/navidrome/master/.github/screenshots/ss-desktop-player.png">
2020-01-24 04:57:51 +01:00
</p>