2020-01-24 01:44:08 +01:00
|
|
|
# Navidrome Music Streamer
|
2016-02-25 00:28:23 +01:00
|
|
|
|
2020-01-24 01:44:08 +01:00
|
|
|
[![Build Status](https://github.com/deluan/navidrome/workflows/Build/badge.svg)](https://github.com/deluan/navidrome/actions)
|
|
|
|
[![Go Report Card](https://goreportcard.com/badge/github.com/deluan/navidrome)](https://goreportcard.com/report/github.com/deluan/navidrome)
|
2016-02-26 16:56:57 +01:00
|
|
|
|
2020-01-24 01:44:08 +01:00
|
|
|
Navidrome is a music collection server and streamer, allowing you to listen to your music collection from anywhere.
|
2020-01-12 04:32:32 +01:00
|
|
|
It relies on the huge selection of available mobile and web apps compatible with [Subsonic](http://www.subsonic.org),
|
|
|
|
[Airsonic](https://airsonic.github.io/) and [Madsonic](https://www.madsonic.org/)
|
2016-02-25 19:51:20 +01:00
|
|
|
|
2020-01-19 21:37:41 +01:00
|
|
|
It is already functional (see [Installation](#installation) below), but still in its early stages.
|
2016-02-26 07:45:04 +01:00
|
|
|
|
2020-01-12 04:32:32 +01:00
|
|
|
Version 1.0 main goals are:
|
2020-01-05 03:16:10 +01:00
|
|
|
- Be fully compatible with available [Subsonic clients](http://www.subsonic.org/pages/apps.jsp)
|
2016-03-25 05:04:22 +01:00
|
|
|
(actively being tested with
|
2020-01-05 03:16:10 +01:00
|
|
|
[DSub](http://www.subsonic.org/pages/apps.jsp#dsub),
|
2020-01-10 04:50:29 +01:00
|
|
|
[Music Stash](https://play.google.com/store/apps/details?id=com.ghenry22.mymusicstash) and
|
|
|
|
[Jamstash](http://www.subsonic.org/pages/apps.jsp#jamstash))
|
2020-01-12 04:32:32 +01:00
|
|
|
- Implement smart/dynamic playlists (similar to iTunes)
|
2020-01-13 23:31:12 +01:00
|
|
|
- Optimized ro run on cheap hardware (Raspberry Pi) and VPS
|
2016-02-25 00:28:23 +01:00
|
|
|
|
2020-01-05 03:16:10 +01:00
|
|
|
### Supported Subsonic API version
|
2016-02-29 20:16:51 +01:00
|
|
|
|
2020-01-21 04:55:59 +01:00
|
|
|
Check the (almost) up to date [compatibility chart](API_COMPATIBILITY.md)
|
2020-01-12 04:32:32 +01:00
|
|
|
for what is working.
|
2016-02-25 00:28:23 +01:00
|
|
|
|
2016-04-01 04:28:33 +02:00
|
|
|
### Installation
|
|
|
|
|
2020-01-12 04:32:32 +01:00
|
|
|
As this is a work in progress, there are no installers yet. To have the server running in your computer, follow
|
|
|
|
the steps in the [Development Environment](#development-environment) section below, then run it with:
|
2020-01-05 03:16:10 +01:00
|
|
|
|
2016-04-01 04:28:33 +02:00
|
|
|
```
|
2020-01-19 21:37:41 +01:00
|
|
|
$ export SONIC_MUSICFOLDER="/path/to/your/music/folder"
|
2020-01-20 03:39:37 +01:00
|
|
|
$ make
|
2016-04-01 04:28:33 +02:00
|
|
|
```
|
2020-01-05 03:16:10 +01:00
|
|
|
|
2020-01-20 19:35:59 +01:00
|
|
|
The server should start listening for requests on the default port 4533. The first time you start the app it will
|
|
|
|
create a new user "admin" with a random password. Check the logs for a line like this:
|
|
|
|
```
|
|
|
|
Creating initial user. Please change the password! password=be32e686-d59b-4f57-b780-d04dc5e9cf04 user=admin
|
|
|
|
```
|
2020-01-06 21:19:14 +01:00
|
|
|
|
2020-01-20 19:35:59 +01:00
|
|
|
You can change this password using the UI. Just login in with this temporary password at http://localhost:4533
|
2020-01-06 21:19:14 +01:00
|
|
|
|
2020-01-24 01:44:08 +01:00
|
|
|
To change any configuration, create a file named `navidrome.toml` in the project folder. For all options see the
|
2020-01-20 19:35:59 +01:00
|
|
|
[configuration.go](conf/configuration.go) file
|
2016-04-01 04:28:33 +02:00
|
|
|
|
2016-02-26 17:39:14 +01:00
|
|
|
### Development Environment
|
|
|
|
|
2020-01-24 00:31:52 +01:00
|
|
|
You will need to install [Go 1.13](https://golang.org/dl/) and [Node 13.7](http://nodejs.org)
|
2016-02-29 20:16:51 +01:00
|
|
|
|
2016-02-26 17:39:14 +01:00
|
|
|
Then install dependencies:
|
2020-01-05 03:16:10 +01:00
|
|
|
|
2016-02-26 17:39:14 +01:00
|
|
|
```
|
2016-10-11 02:27:09 +02:00
|
|
|
$ make setup
|
2020-01-05 03:16:10 +01:00
|
|
|
```
|
2016-02-26 17:39:14 +01:00
|
|
|
|
2016-10-11 02:27:09 +02:00
|
|
|
Some useful commands:
|
2016-02-26 17:39:14 +01:00
|
|
|
|
2016-02-27 09:35:01 +01:00
|
|
|
```bash
|
|
|
|
# Start local server (with hot reload)
|
2020-01-20 03:39:37 +01:00
|
|
|
$ make
|
2016-02-27 09:35:01 +01:00
|
|
|
|
2016-02-29 20:16:51 +01:00
|
|
|
# Run all tests
|
2016-10-11 02:27:09 +02:00
|
|
|
$ make test
|
2016-02-27 09:35:01 +01:00
|
|
|
```
|
2016-02-26 17:39:14 +01:00
|
|
|
|
2016-03-13 17:33:40 +01:00
|
|
|
### Copying
|
2016-02-25 00:28:23 +01:00
|
|
|
|
2020-01-24 01:44:08 +01:00
|
|
|
Navidrome - Copyright (C) 2017-2020 Deluan Cotts Quintao
|
2016-02-24 00:41:35 +01:00
|
|
|
|
2017-04-01 15:21:55 +02:00
|
|
|
The source code is licensed under GNU Affero GPL v3. License is available [here](/LICENSE)
|