🎧☁️ Modern Music Server and Streamer compatible with Subsonic/Airsonic
Go to file
Deluan 4d06d250e6 fix: relative path was not working for rootFolder started with '.' 2020-02-03 17:53:59 -05:00
.github ci: create versions with goreleaser 2020-01-26 20:09:25 -05:00
assets Add warning when using external assets 2020-01-24 20:35:27 -05:00
bin Removed unused scripts (moved to Makefile) 2016-10-10 21:03:21 -04:00
conf feat: improve logs, remove config for disable authentication 2020-02-01 17:23:03 -05:00
consts feat: add server name and version to all responses 2020-01-30 14:43:24 -05:00
db fix: only create db entities in first migration if they don't exist 2020-02-03 17:48:48 -05:00
engine refactor: read musicFolderId from request (but still don't use it) 2020-02-01 17:23:03 -05:00
log feat: improve logs, remove config for disable authentication 2020-02-01 17:23:03 -05:00
model refactor: read musicFolderId from request (but still don't use it) 2020-02-01 17:23:03 -05:00
persistence refactor: use stdlib `filepath.FromSlash` 2020-02-03 17:53:59 -05:00
scanner fix: relative path was not working for rootFolder started with '.' 2020-02-03 17:53:59 -05:00
server feat: disable scanner if ScanInterval is set to 0 2020-02-03 11:58:21 -05:00
static Add git info to version 2020-01-25 11:06:04 -05:00
tests fix: tests 2020-01-26 18:25:12 -05:00
ui chore: update all node dependencies 2020-02-03 08:39:39 -05:00
utils Rename env vars prefix to ND_ 2020-01-24 01:29:31 -05:00
.dockerignore ci: create versions with goreleaser 2020-01-26 20:09:25 -05:00
.gitignore fix: relative path was not working for rootFolder started with '.' 2020-02-03 17:53:59 -05:00
.goreleaser.yml chore: go mod tidy 2020-01-30 16:36:43 -05:00
.nvmrc Upgrade node to latest 2020-01-23 18:32:49 -05:00
API_COMPATIBILITY.md docs: update `stream` notes 2020-02-03 11:50:46 -05:00
Dockerfile feat: add server name and version to all responses 2020-01-30 14:43:24 -05:00
LICENSE Change license to GPLv3 2020-01-22 14:48:38 -05:00
Makefile fix: always build everything when calling `buildall` target 2020-02-03 08:42:15 -05:00
Procfile.dev Add ui subfolder, bootstrapped a "hello-world" React-Admin app, changed Makefile to start both apps in dev mode 2020-01-14 15:34:59 -05:00
README.md docs: update README 2020-01-30 16:07:54 -05:00
banner.go feat: add server name and version to all responses 2020-01-30 14:43:24 -05:00
docker-compose.yml Rename env vars prefix to ND_ 2020-01-24 01:29:31 -05:00
go.mod chore: update ginkgo/gomega dependencies 2020-02-03 08:41:36 -05:00
go.sum chore: update ginkgo/gomega dependencies 2020-02-03 08:41:36 -05:00
main.go refactor: better integration between `db` and `persistence` packages 2020-02-01 17:23:03 -05:00
reflex.conf Rename project to Navidrome 2020-01-23 19:44:08 -05:00
wire_gen.go Rename project to Navidrome 2020-01-23 19:44:08 -05:00
wire_injectors.go Rename project to Navidrome 2020-01-23 19:44:08 -05:00

README.md

Navidrome Music Streamer

Build Last Release Docker Pulls

Navidrome is an open source web-based music collection server and streamer. It gives you freedom to listen to your music collection from any browser or mobile device.

This is a fully functional alpha quality software. Expect some changes in the feature set and the way it works.

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 or join the chat in our Discord server

Features

  • Handles very large music collections
  • Streams virtually any audio format available
  • Reads and uses all your beautifully curated metadata (id3 tags)
  • Multi-user, each user has their own play counts, playlists, favourites, etc..
  • Very low resource usage: Ex: with a library of 300GB (~29000 songs), it uses less than 50MB of RAM
  • Multi-platform, runs on macOS, Linux and Windows. Docker images are also provided
  • Automatically monitors your library for changes, importing new files and reloading new metadata
  • Modern and responsive Web interface based on Material UI, to manage users and browse your library
  • Compatible with the huge selection of clients for Subsonic, Airsonic and Madsonic. See the complete list of available mobile and web apps

Road map

This project is being actively worked on. Expect a more polished experience and new features/releases on a frequent basis. Some upcoming features planned:

  • Transcoding/Downsampling on-the-fly
  • Last.FM integration
  • Integrated music player
  • Pre-build binaries for Raspberry Pi
  • Smart/dynamic playlists (similar to iTunes)
  • Jukebox mode
  • Sharing links to albums/songs/playlists
  • Podcasts

Installation

Various options are available:

Pre-build executables

Just head to the releases page and download the latest version for you platform. There are builds available for Linux, macOS and Windows (32 and 64 bits).

Remember to install ffmpeg in your system, a requirement for Navidrome to work properly.

If you have any issues with these binaries, or need a binary for a different platform, please open an issue

Docker

Docker images are available. They include everything needed to run Navidrome. Example of usage:

# This is just an example. Customize it to your needs.

version: "3"
services:
  navidrome:
    image: deluan/navidrome:latest
    ports:
      - "4533:4533"
    environment:
      # All options with their default values:
      ND_MUSICFOLDER: /music
      ND_DATAFOLDER: /data
      ND_SCANINTERVAL: 1m
      ND_LOGLEVEL: info  
      ND_PORT: 4533
    volumes:
      - "./data:/data"
      - "/Users/deluan/Music/iTunes/iTunes Media/Music:/music"

Build from source

You will need to install Go 1.13 and Node 13.7.0. You'll also need ffmpeg installed in your system. The setup is very strict, and the steps bellow only work with these specific versions (enforced in the Makefile)

After the prerequisites above are installed, clone this repository and build the application with:

$ git clone https://github.com/deluan/navidrome
$ cd navidrome
$ make setup        # Install tools required for Navidrome's development 
$ make buildall     # Build UI and server, generates a single executable

This will generate the navidrome binary executable in the project's root folder.

Running for the first time

Start the server with:

./navidrome

The server should start listening for requests on the default port 4533

After starting Navidrome for the first time, go to http://localhost:4533. It will ask you to create your first admin user.

For more options, run navidrome --help

Screenshots

Subsonic API Version Compatibility

Check the up to date compatibility table for the latest Subsonic features available.