A cool local music player made in PHP/jQuery.
It can be useful if you have local music files you want to play, especially if you want to cast it to your Google speakers as Spotify does not allow this for local files.
- Supports Windows media keys
- Download from playlist
- Delete from playlist
- Shuffle playlist
- Loop song
- Upload files directly from web UI
- Change settings from GUI
- Queue
- Favorites
- Support multiple playlists
- Browser refresh persistency
- Session sharing
You could build a docker container running mp3-web using the dockerfile.
# Get the Dockerfile
curl -O https://raw.githubusercontent.com/Darknetzz/mp3-web/refs/heads/main/Dockerfile
# Build the container
docker build -t mp3-web:main .
# Run the container (replace 9096 with any port you want)
docker run -d -p 9096:80 mp3-web:main- Clone this repo or download the latest release to your webserver with PHP.
- Run
composer installfrom the directory (optional, but required to display durations) - Add some music in the subfolder
music(or whatever you choose inconfig.php) - Open the page in a browser and start listening!
Usually the main reason for this is permissions. You might see error messages similar to this:
- The directory
<PATH>is not writable. Run the following commands, replacing<PATH>with the mp3-web directory:
# Example: chown -R www-data:www-data /var/www/html/mp3-web
chown -R www-data:www-data <PATH>
# Example: chmod -R 775 /var/www/html/mp3-web
chmod -R 775 <PATH>If your music folder is in a remote directory and the ownership can't be changed, you might have to replace 775 with 777.