Skip to content
An elegant HTML5 web folder player for parties and/or private music collections, with playlist management that's just better.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Music Folder Player

An elegant HTML5 web folder player for parties and/or private music collections, with a playlist system that all players should have had. It does not use a database (so it's alway up-to-date), but can easily handle folders with 25,000 songs or more. It has no dependencies other than PHP and installation costs less than 2 minutes. The design should be fully responsive on CSS3-compatible browsers.

Dark theme via musictheme.css




  • Click on cover image to zoom (300x300px, again for full size)
  • Click on current song or folder name to find it in the library


  • Drag and drop to change the playlist order or drag to bin to remove
  • Random playback will prevent choosing already played songs (unless "Play next" is used)
  • Click on a song to play directly
  • Right-click (long-press) a song to find it in the library
  • Choose how to continue when the playlist is exhausted:
    • Stop playback
    • Repeat the playlist
    • Continue from last song's position in library
    • Randomly select unplayed songs from the (filtered) library
  • Playlist and configuration will be saved to the browser's Local Storage if possible
  • Load/save online playlists (optional)
  • Import/export playlists from/to a local file


  • Rebuilds the tree of a specified folder, showing only files with supported extensions
  • Sports a library filter to quickly find songs
  • Click a song to play (or enqueue when "Enqueue" mode is enabled)
  • Clicking on a song will always keep the playlist intact
  • Right-click (long-press) a song to play it next
  • Right-click (long-press) a folder to add all its songs to the playlist
  • Use arrow keys to traverse the library tree, Enter to play/enqueue, or Shift-Enter to play next/add folder


  • Password lock the playlist and playlist controls (allowing only Enqueue, Play next, Play/pause and Share)
  • Tip: use OpenKiosk and disable Set inactive terminal
  • Prevents adding a song if it's already queued up
  • Do not add previously played songs to playlist (optional)


  • Download a song or zipped folder (only tested on a Linux server)
  • Share a song, folder or playlist link (library features/options will be hidden)
  • Share links directly to WhatsApp (optional)

List of hotkeys

Hotkey Command
Z Zoom cover image (full size, 300px)
0 Stop playback (time to 0:00)
Space Play/pause
[ Play previous
] Play next
- Jump back 5s
+ Jump forward 5s
Shift - Volume down
Shift + Volume up
U Show/hide volume
M Toggle Mute
E Toggle "Enqueue songs on click"
R Toggle "Randomize upcoming playlist items"
O Toggle "Crossfade between songs"
P Show/hide "Playlist options"
S Show/hide "Share options"
L Toggle "Lock playlist and playback controls"
D Load playlist: Add songs from saved playlist
V Save playlist: Save playlist online
I Import playlist: Add songs from exported playlist
X Export current playlist to file
A Define action after last playlist item
C Clear playlist
F Focus library filter
Esc Reset library filter
Arrow keys Navigate library tree
Enter Play/Add to playlist
Shift-Enter Play song next/Add folder to playlist


You can have a test setup running within 2 minutes. For all the details, check the Wiki.


All credits are due, as well as my sincere thanks!

You can’t perform that action at this time.