musicco

Keyboard Shortcuts

Playback

`←`	Previous track
`→`	Next track
`Shift` + `←`	Previous album
`Shift` + `→`	Next album
`↑`	Volume up
`↓`	Volume down
`Shift` + `↑`	Move current album up in playlist
`Shift` + `↓`	Move current album down in playlist
`Space`	Play/pause
`0` - `9`	Seek to 0%-90% of current track
`e`	Seek to end of current track
`Alt` + `u`	Play random album from playlist
You can also use media keys on most multimedia keyboards

Browser

`j` / `k`	Highlight previous / next item
`o`	Open current selection
`a`	Queue current selection

Main

`h`	Show help
`b`	Show browser
`/`	Go to filter box in browser
`s`	Show search
`t`	Focus tab header
`p`	Show playlist
`i`	Show artist information
`l`	Show lyrics
`c`	Show listening history
`g`	Show settings
`Esc`	Hide all panels
`Shift` + `p`	Enter Picture-in-Picture mode
`u`	Suggest random albums to add to the playlist
`Shift` + `u`	Suggest random new albums to add to the playlist

Ninja

`Shift` +	Previous album
`Shift` +	Next album
`Shift` +	Suggest random new albums to add to the playlist
`Alt` +	Play random album from playlist
`Shift` + /	Move album to top / bottom
`Shift` +	Remove all previous albums
`Ctrl` +	Remove all following albums
`Alt` +	Remove all other albums

Mobile

Swipe Album Art

	Previous track
	Next track
	Volume up
	Volume down


Long Press

Album / Track	Open context menu
	Previous album
	Next album
	Add new albums to playlist
/	Move album to top/bottom
	Remove all previous albums
/ /	Play random album from playlist

Find Out More at musicco.app

musicco

A web based player for your music collection

musicco is a light-weight, web-based streaming music player for your local library

It runs easily on a very low-powered NAS like a dns-323

It'll basically work wherever you can run php with sqlite and lighttpd or nginx

Modern desktop and mobile browsers love it!

musicco is inspired by

musicco scans your music folder and builds a database of your music collection, retrieving missing cover art from coverartarchive.org, artist information from wikipedia.org and song lyrics from chartlyrics.com.

Like musicco? Wanna buy me a beer?

Release History

4.0.0 (in development)

Fix focus on uncover panel
Add an option to force-show new albums by default
Make the info panel load images as you scroll on mobile browsers
Make the widescreen layout work on regular 16x9 desktops
Add keyboard shortcuts to trigger uncover functionality
Enter picture-in-picture mode when minimizing window
Improve style of help panel
Improve style of more elements in info panel
Upgrade to jQuery UI 1.14.2
Show old albums automatically when there are no new albums
Include album year in uncover screen
Upgrade to jQuery 4.0.0
Fix mute status reset and make mute status work when casting
Fix syntax errors for php 8 / sqlite
Improve medium layout, ensuring tabs fit on a single line
Upgrade to fancytree 2.38.5
Use smaller volume increments
Update play/pause state correctly
Improve image viewer layout
Scroll playlist to follow albums being moved up and down
Upgrade to wavesurfer 7.12.1
Upgrade to font-awesome 7.1.0

3.3.0 (3rd January 2025)

Allow filtering search results by artist, album or song
Upgraded to fancytree 2.38.4
Upgrade to Montserrat 9.000
Upgrade to color-thief 2.6.0
Upgrade to wavesurfer 7.8.14
Upgrade to font-awesome 6.7.2
Upgrade to jquery-ui 1.14.1
waveform style improvements

3.2.4 (16th September 2023)

Fix unwanted horizontal scrolling in documentation

3.2.3 (16th September 2023)

Upgraded website and documentation
Fixed opening of images in artist bio
Clear progress bar when an error occurs loading the playlist
Improve css layouts to work with various pixel densities
Upgrade to js-cookie 3.0.5
Queue icon in uncover dialog is hard to hit
Cannot play tracks that contain a #
Upgrade to wavesurfer 7.3.2
Upgrade to font-awesome 6.4.2
Embedd font resources
Upgrade to jquery 3.7.1
Upgrade to color-thief 2.4.0

3.2.2 (9th February 2023)

Allow filtering listening history
Display progress bar as a waveform
Fix medium viewer css not being triggered
Load album art when queing music 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

3.2.1 (9th May 2022)

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

3.2.0 (26th January 2022)

Automatically build a smart playlist of all new music
Quickly refresh newly renamed albums
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

3.1.2 (13th October 2021)

Fixed script error when displayign uncover dialogue

3.1.1 (13th October 2021)

Fixed cover art display in uncover dialogue
Fixed taphold events
Minor UI fixes

3.1.0 (12th October 2021)

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

3.0.0 (4th December 2020)

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

2.0.0 (28th October 2018)

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!

1.3.0 (24th September 2016)

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
Remove all previous albums with shift-click or all following albums with control-click
Added keyboard support in search results
Added search links when no artist or lyrics are found

1.2.0 (May 3rd 2016)

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
Added search links when no artist or lyrics are found

1.1.0 (25 September 2014)

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

1.0.3

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
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 5 random albums to your playlist

1.0.2

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

1.0.1

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

1.0.0 (27 April 2013)

Initial release

Queue selected Uncover more