Skip to content
A self-hosted web-based music player - just drag, drop and listen 🎵
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
template remove redundant files Jun 27, 2019
www
README.md completely rewrote readme Jun 25, 2019

README.md

Groovebox Music Player

A self-hosted web-based music player - just drag, drop and listen 🎵

Gif of radio client

Features

  • Add an infinite amount of playlists
  • Tracks are live as soon as they hit the playlist folder
  • Powered by PHP - no continuous program running on a port in the background

How To Install

Prerequisites

  • Functioning web-server
  • PHP7

Installation Steps

  1. Copy contents of www/ (api/, client/ and tracks/) to a directory in your web-server - e.g. groovebox/

Usage

Add Music

All music is added to the tracks/ folder and sorted into playlists (sub-folders) of your choice - e.g. tracks/disco/

  1. Create a folder within the tracks/ folder. Any folder created will act as a playlist (you can create as many playlists as you like)

  2. Move all the music you want to play into the playlist folder - e.g. disco/my-awesome-track.mp3

Accessing Playlists

  1. To start listening to a playlist, add the name of the playlist folder into the URL as a parameter - https://example.com/groovebox/client/?playlist=disco
You can’t perform that action at this time.