Warning

This project is mostly made for fun, and it will probably never be very good or secure

Screenshots

The screenshots below are all taken with the default configurations. That's because you can't configure anything.

• cool dynamic colours based on the album art

• the full player with the queue song selector and everything

• settings page

Dependencies/Prerequisites

• A webserver with PHP support enabled (like Apache or Nginx)
• PHP, of course
• Preconfigured MPD
  • As of right now, this project connects to 127.0.0.1 at port 6767. However, you can change this in this file. Support for adding your own server will likely be added in the future.

Features

• Access to everything: Easy access to your entire queue and all your playlists (and maybe more to come?)
• Adaptive UI: Dynamically fetches colours from the current song's album art and uses it across the UI
• Customizable: Very customizable - you can tweak everything you want (eventually)
• Keyboard shortcuts: Easily control your player with intuitive keyboard shortcuts

Player shortcuts

Keyboard shortcut	Action/Description
Space	Pauses the currently playing song.
←	Skips/seeks 5 sekonds backwards in the currently playing song.
→	Skips/seeks 5 seconds forwards in the currently playing song.
↓	Decreases the volume by 5%.
↑	Increase the volume by 5%.
k	Plays the previous song in the queue.
j	Plays the next song in the queue.
0-9	Skips/seeks to a specific point in the currently playing song. E.g 4 for 40% through or 0 to go to the start.
,	Opens/closes the settings menu.

YT-DLP command to download music in the highest quality while extracting all metadata

yt-dlp 'link to cool music on youtube' \
-f "bestaudio[ext=m4a]" \
--embed-thumbnail \
--convert-thumbnail jpg \
--embed-metadata \
--exec-before-download "ffmpeg -i %(thumbnails.-1.filepath)q -vf crop='ih:ih' _%(thumbnails.-1.filepath)q && mv _%(thumbnails.-1.filepath)q %(thumbnails.-1.filepath)q" \
--output "%(artist)s - %(title)s.%(ext)s"

Create a bash script to make it easier to run!

How to get synced lyrics from your songs

This command uses a python program called syncedlyrics.

for file in *.m4a; do syncedlyrics "${file%.m4a}" -o "${file%.m4a}.lrc"; done

Alternatively, you can find the song you want on LRCLIB and download the lyrics from there, but that isn't as cool as doing it with a command 😉

Handwritten with ❤️ and lots of Urge