Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

🎶 musicco

GitHub Release Date GitHub commits since latest release (by date) GitHub last commit GitHub issues musicco musicco is a web player for your music library Host it on a NAS and start streaming your music from any browser.
This is especially great on low-spec NAS that don't have enough power to host Squeezebox, Subsonic or an ITunes Server.
Check out for more information or try the demo at

Follow @musiccoapp

💡 Features

📱 Fully responsive player for all your devices


🔎 Browsing, filtering and searching the music library


ℹ️ Artist information and lyrics for currently playing track


⌨️ Keyboard support


🔐 Optional authentication and multi-user support for saving everybody's playlists


🖼️ Showcase that beautiful album art


⚙️ Required php extensions

  • pdo_sqlite (mandatory)
  • php7.0-xml (mandatory)
  • php7.0-mbstring (mandatory)
  • openssl (optional, for cover art support)
  • zip (optional, for download support)

📚 Libraries

Library Bundled Latest
color-thief 2.4.0 GitHub release (latest by date)
detect_swipe 2.1.5 GitHub release (latest by date)
fancytree 2.38.3 GitHub release (latest by date)
fontawesome 6.3.0 GitHub release (latest by date)
jQuery 3.6.4 GitHub release (latest by date)
jQuery-qrcode 0.18.0 GitHub tag (latest by date)
jQuery-ui 1.13.2 GitHub release (latest by date)
jQuery-ui-contextmenu 1.18.1 GitHub release (latest by date)
jquery-taphold 1.1.0 GitHub release (latest by date)
js-cookie 3.0.1 GitHub release (latest by date)
jsmediatags 3.9.5 GitHub release (latest by date)
normalise 1.0.0 GitHub release (latest by date)
wavesurfer 6.6.0 x micser GitHub release (latest by date)

💗 Love

musicco is in great part inspired by / technically relies or has relied on the following great projects:

musicco scans your music folder and builds a database of your music collection, retrieving missing cover art from, artist information from and song lyrics from

📒 Changelog

v3.2.3 (in development)

  • Upgrade to wavesurfer 6.6.0
  • Upgrade to jquery 3.6.4
  • Upgrade to color-thief 2.4.0


  • Allow filtering listening history
  • Display progress bar as a waveform
  • Fix medium viewer css not being triggered
  • Load album art when queing musinc instead of when playing it
  • Upgraded to fancytree 2.38.3
  • Upgraded to jquery-ui 1.13.2
  • Upgraded to jquery 3.6.3
  • Upgraded to font-awesome 6.3.0
  • Added visible icons to trigger Player Panel shortcuts
  • Improved annotated lyrics styling
  • Remove icon clutter on smaller screens


  • Fixed library refresh on successful quick scan
  • Upgrade to font-awesome 6.1.1


  • Quickly refresh newly renamed albums
  • Automatically build a smart playlist of all new music
  • Improved rotation detection
  • Improved show old filter state
  • Improved dynamic theme colours
  • Improved library rebuild speed
  • Minor Listening History improvements
  • Improved Uncover dialogue
  • Minor bug fixes


  • Fixed script error when displaying uncover dialogue


  • Fixed cover art display in uncover dialogue
  • Fixed taphold events
  • Minor UI Fixes


  • Read album art from id3 tag
  • Save "Show old albums" option between sessions
  • Added an option to keep screen on
  • Fixed some issues with casting on Android
  • Improved QR Code styling
  • Fix adding of duplicate albums in playlist
  • Added confirmation dialogs before clearing items
  • Improved sharing dialog
  • Improved uncover dialog
  • Improved lyrics provider
  • Improved landscape view on mobile
  • Dependency updates


  • Added casting directly from player
  • Allow viewing listening history
  • Allow re-running the setup wizard
  • Fixed an issue where the mini toolbar would show up when unwanted
  • Minor UI refresh around info panel, header, player controls, context menus and album art
  • Fixed transparency effects
  • Improved layout for widescreen devices
  • Improved browse panel performance
  • Save active panel setting
  • Notify clients if they are out of date
  • Dependency updates
  • Minor bugfixes


  • Fixed issue playing files containing a #
  • Fixed general scrolling issue of long lists


  • Fixed issues for screens with 1024x768 resolutions
  • Improved URL handling for cover uploads


  • Fixed background blur for recent Chrome versions


  • Use native html audio instead of jplayer / jplayerPlaylist
  • Refreshed UI
  • Theme selector and dynamic theme
  • Added support for multiple playlists per user
  • Added support for marking albums and tracks as favourites
  • Improved controls for touchcreen browsers
  • Added support for rich notifications on Android using Media Session API
  • Added play/pause and skip actions to desktop notification
  • Added support for quickly adding an album without scanning the entire library
  • Save your favourite albums
  • Handle accent-insensitive search
  • Improved webapp manifest so you can add musicco to your Android home screen
  • Fixed many other things


  • Bug fixes centered around track seeking and resuming current play position, added Uncover button to header in square mode.


  • Save current play time in the playlist, show album year in the banner


  • Small improvements to info shown in square mode, fixed bug about duplicate trigger on volume up / down


  • Quick fix for an issue handling long playlists that did not restore their position properly and improved handling of keypad to seek track and ignore meta key presses.


  • Quick fix for left and right arrows skipping 2 tracks instead of 1


  • Improved sharing banner to display more info
  • Added a new template for square windows to highlight album art more
  • Added seeking in current track with 1-9 keys
  • Fixed playlist management issues when moving or deleting albums
  • Made it possible to move albums to the beginning / end of the playlist with a shift-click
  • Added keyboard support in search results
  • Added search links when no artist or lyrics are found.


  • Quick fix to enable the initial library build to work out of the box


  • Compatibility fixes for different versions of Apache / php / sqlite


  • Removed Android client, work on making the player responsive instead
  • Work on database performance
  • Loading of .lrc files as long as they have the same name of the song currently playing
  • Allow users to upload their own album covers for the currently playing song from the web player
  • Reorder albums in the current playlist
  • Allow sharing a link to an album to guest users
  • New default theme
  • Improved artist info from Wikipedia
  • Use auth tokens for logging in instead of credentials
  • More pattern configuration options for more custom library tree structures
  • Shift-click previous/next buttons (or shift-use arrow keys) to skip to the next album in the playlist


  • Android client and under-the-hood improvements to suppport it
  • Added configuration option for cover name and log file
  • Improved playlist panel
  • Fixed download option for administrators in the playlist and the browser panels


  • More elegant management of the Fetch Cover button to provide more information about the cover fetching progress
  • Nicer playlist screen that groups tracks by album
  • Also upgraded to jplayer 2.4.0/JQuery 2.0.3 and adapted the CSS for better display on mobile screens with a 320x480 resolutions
  • HTML notifications are working again in this version, and keyboard actions are improved as a result
  • New feature Uncover! adds 10 random albums to your playlist


  • Fixed minor display bugs introduced by 1.0.1 with z-index management.


  • Improved cover management when downloading from cover art provider
  • Added a button to manually fetch a cover
  • Improved artist information panel and added an icon to indicate that some information is still being loaded from the server


  • initial release


musicco is a web player for your music library Host it on a NAS and start streaming your music from any browser.






No packages published