Waveline Music Server

Use the 3.1.0 version if you wish to keep using the mongodb version

Getting Started

Waveline works with following databases:

postgres

mysql

cockroachdb

mariadb

sqlite

mssql

You can pull the latest Waveline image from Docker Hub and run it by using the following command:

docker run -d --name="Waveline-Server" \
  -e DB_DRIVER=sqlite \
  -e MUSIC_PATH=/music \
  -e TRANSCODE_PATH=/transcoded-audio \
  -e ART_PATH=/album-art \
  -e SPOTIFY_ID=YOUR_SPOTIFY_ID \
  -e SPOTIFY_SECRET=YOUR_SPOTIFY_SECRET \
  -e LAST_FM_KEY=YOUR_LAST_FM_KEY \
  -e AUTH_ENABLED=true \
  -e API_KEY=12345 \
  -e PORT=5000 \
  -e HOST=http://127.0.0.1:5000 \
  -p 5000:5000 \
  -v YOUR_MUSIC_PATH:/music \
  -v ./album-art:/album-art \
  -v ./transcoded-audio:/transcoded-audio \
  --restart unless-stopped \
  wellenline/waveline-server:latest

Using Docker-Compose

version: '3'
services:
  app:
    container_name: waveline-api
    restart: always
    build:
      context: https://github.com/Wellenline/waveline-server.git
    environment:
      - DB_DRIVER=sqlite # postgres,  mysql, cockroachdb, mariadb, sqlite, mssql,
      - DB_HOST=DATABASE_HOST
      - DB_PORT=DATABASE_PORT
      - DB_USERNAME=DATABASE_USERNAME
      - DB_PASSWORD=DATABASE_PASSWORD
      - DB_NAME=DATABASE_NAME
      - MUSIC_PATH=/music
      - TRANSCODE_PATH=/transcoded-audio
      - ART_PATH=/album-art
      - SPOTIFY_ID=YOUR_SPOTIFY_ID
      - SPOTIFY_SECRET=YOUR_SPOTIFY_SECRET
      - LAST_FM_KEY=YOUR_LAST_FM_API_KEY
      - API_KEY=12345 # remove if you wish to disable auth
      - PORT=5000
      - HOST=http://127.0.0.1:5000
    volumes:
      - YOUR_MUSIC_PATH:/music # Mount your music inside docker
      - ./album-art:/album-art # Mount album art cache inside docker
      - ./transcoded-audio:/transcoded-audio # Mount transcoded audio cache inside docker
    ports:
      - 5000:5000

docker-compose up -d

Building From Source

You'll need NPM installed before continuing.

Clone the repo:

sh
git clone https://github.com/wellenline/waveline-server.git
cd waveline-server

Initialize the build using NPM:

sh
npm i
npm run build
npm start

Sample .env file:

env
DB_DRIVER=sqlite # postgres,  mysql, cockroachdb, mariadb, sqlite, mssql,
DB_HOST=DATABASE_HOST
DB_PORT=DATABASE_PORT
DB_USERNAME=DATABASE_USERNAME
DB_PASSWORD=DATABASE_PASSWORD
DB_NAME=DATABASE_NAME
MUSIC_PATH=PATH_TO_YOUR_MUSIC
TRANSCODE_PATH=./transcoded-audio
ART_PATH=./album-art
SPOTIFY_ID=YOUR_SPOTIFY_ID
SPOTIFY_SECRET=YOUR_SPOTIFY_SECRET
LAST_FM_KEY=YOUR_LAST_FM_API_KEY
API_KEY=xxxxxxxxxxxx # replace it with something more secure
PORT=5000
HOST=http://127.0.0.1:5000

Artist Pictures (from Spotify)

To display artist pictures you need to sign up for Spotify Developer Account and create a new application https://developer.spotify.com/dashboard/login

Artist Bio, similar artists and tags (from Lastfm)

To display artist bio, get similar artists and tags you need to create a new Lastfm application https://www.last.fm/api/account/create

Roadmap

Waveline is a personal project and my current goals are

• Offline mode
• Transcoding
• Casting support (chromecast)
• Desktop app Wellenline/waveline-web
• iOS version

API

System

| |Description | |----------------|-------------------------------| |

GET /system/info

Tracks

| |Description | |----------------|-------------------------------| |

GET /tracks

GET /tracks/play/:id

GET /tracks/like/:id

GET /tracks/random

new

Search

| |Description | |----------------|-------------------------------| |

GET /search

Albums

| |Description | |----------------|-------------------------------| |

GET /albums

GET /albums/:if

GET /albums/random

new

GET /albums/art/:id

Artists

| |Description | |----------------|-------------------------------| |

GET /artists

GET /artists/random

new

Playlists ()

| |Description | |----------------|-------------------------------| |

GET /playlists

POST /playlists

{ name: string, picture?: string }

POST /playlists/:id

{ track: number }

PUT /playlists/:id

{ name: string, tracks: [] }

DELETE /playlists/:id

DELETE /playlists/:id/:track

Genres

| |Description | |----------------|-------------------------------| |

GET /genres