{"id":16565274,"url":"https://github.com/ltguillaume/music-folder-player","last_synced_at":"2025-04-05T04:09:22.092Z","repository":{"id":50254762,"uuid":"135811669","full_name":"ltguillaume/music-folder-player","owner":"ltguillaume","description":"An elegant HTML5 web folder player for parties and/or private music collections, with sharing options and playlist management that's just better","archived":false,"fork":false,"pushed_at":"2025-02-18T23:22:02.000Z","size":3247,"stargazers_count":125,"open_issues_count":2,"forks_count":33,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-03-29T03:06:54.691Z","etag":null,"topics":["audio","audio-player","crossfade","enqueue","folder-structure","html5-audio","mp3player","music","music-player","no-database","parties","playlist"],"latest_commit_sha":null,"homepage":"https://codeberg.org/ltguillaume/music-folder-player","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ltguillaume.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["buymeacoff.ee/ltGuillaume"]}},"created_at":"2018-06-02T11:22:17.000Z","updated_at":"2025-03-20T11:49:20.000Z","dependencies_parsed_at":"2023-02-01T11:02:06.626Z","dependency_job_id":"e0cd3174-6828-403b-8553-f9c1741482bc","html_url":"https://github.com/ltguillaume/music-folder-player","commit_stats":null,"previous_names":["ltguillaume/musicfolderplayer"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltguillaume%2Fmusic-folder-player","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltguillaume%2Fmusic-folder-player/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltguillaume%2Fmusic-folder-player/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltguillaume%2Fmusic-folder-player/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ltguillaume","download_url":"https://codeload.github.com/ltguillaume/music-folder-player/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247284948,"owners_count":20913704,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","audio-player","crossfade","enqueue","folder-structure","html5-audio","mp3player","music","music-player","no-database","parties","playlist"],"created_at":"2024-10-11T20:46:39.688Z","updated_at":"2025-04-05T04:09:22.057Z","avatar_url":"https://github.com/ltguillaume.png","language":"JavaScript","funding_links":["buymeacoff.ee/ltGuillaume"],"categories":[],"sub_categories":[],"readme":"# Music Folder Player\nby ltGuillaume: [Codeberg](https://codeberg.org/ltGuillaume) | [GitHub](https://github.com/ltGuillaume) | [Buy me a beer](https://buymeacoff.ee/ltGuillaume) 🍺\n\nAn 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.\n\n![Screenshot](SCREENSHOT.png)\n\n## Overview\n\n#### Player\n- Click on cover image to zoom (300x300px, again for full size)\n- Click on current song or folder name to find it in the library\n- Right-click Volume to mute\n- Right-click Next to skip current artist\n\n#### Options\n- Enqueue: Click on songs in the library to add songs to the end of the playlist, instead of playing them (next). Right-click to suggest a random song to enqueue.\n- Random: pick the next song randomly from the upcoming songs (songs added using \"Play next\" take precedence)\n\t- Right-click Random to shuffle upcoming songs (songs added using \"Play next\" will stay in place)\n- Crossfade: start playing the next song 10s before ending the current and fade out the current song\n- Password lock the playlist and playlist controls (allowing only Enqueue, Play/pause and Share)\n\t- Tip: use [OpenKiosk](http://openkiosk.mozdevgroup.com) and disable _Set Inactive Terminal_\n- Do not add previously played songs to playlist (optional)\n\n#### Playlist\n\n\u003cimg src=\"SCREENSHOT_AFTERPL.png\" align=\"right\" width=\"200\"\u003e\n\n- Click on a song to play directly\n- Drag and drop to change the order, drag to bin to remove\n- Right-click a song to find it in the library\n- Choose how to continue when the playlist is exhausted:\n\t- Stop playback\n\t- Repeat the playlist\n\t- Continue from the last played song's position in the library\n\t- Randomly select unplayed songs from the (filtered) library\n- Playlist and configuration will be saved to the browser's Local Storage if possible\n- Load/save online playlists (can be disabled)\n- Import/export playlists from/to a local file\n\n#### Library\n- Rebuilds the tree of a specified folder, showing only files with supported extensions\n- Use arrow keys to traverse the library tree, Enter to play/enqueue, or Shift-Enter to play next/add folder\n- Click a song to play (or enqueue when \"Enqueue\" mode is enabled)\n- Clicking on a song will never clear the playlist (looking at you, ol' Winamp)\n- Play next: right-click (long-press) a song to play it next (\"Play next\" songs will play in \"FIFO\" order)\n- Right-click a folder to add all its songs to the playlist\n- Prevents adding a song if it's already queued up (unless \"Play next\" is used)\n- Sports a library (instant) filter to quickly find songs\n\n#### Sharing\n\n\u003cimg src=\"SCREENSHOT_SHARE.png\" align=\"right\" width=\"330\"\u003e\n\n- Download a song or zipped folder\n- Share a song, folder or playlist link (library features/options will be disabled)\n- Share links directly to email, social media or use your device's native share options (optional)\n\n#### Themes\n- Define your own subset of the available themes and variants in `music.ini`\n- \u003cspan style=\"background-color:#1a1a1a;color:#b4b4b4\"\u003e\u0026nbsp;Black\u0026nbsp;\u003c/span\u003e, \u003cspan style=\"background-color:#141a21;color:#b4b4b4\"\u003e\u0026nbsp;blue\u0026nbsp;\u003c/span\u003e, \u003cspan style=\"background-color:#14221a;color:#b4b4b4\"\u003e\u0026nbsp;green\u0026nbsp;\u003c/span\u003e, \u003cspan style=\"background-color:#23272c;color:#b4b4b4\"\u003e\u0026nbsp;gray\u0026nbsp;\u003c/span\u003e and \u003cspan style=\"background-color:#eaeef2;color:#444\"\u003e\u0026nbsp;light\u0026nbsp;\u003c/span\u003e color themes\n- Can be mixed with variants (see `music.theme.css`):\n\t- Material-like rounded UI and compact retro UI\n\t- Colorize \u003cspan style=\"background-color:#1a6eac;color:#fff\"\u003e\u0026nbsp;hovered buttons\u0026nbsp;\u003c/span\u003e\n\t- \u003cspan style=\"color:#1d91f0\"\u003eBlue\u003c/span\u003e, \u003cspan style=\"color:#00bd35\"\u003egreen\u003c/span\u003e, \u003cspan style=\"color:#eb6600\"\u003eorange\u003c/span\u003e and \u003cspan style=\"color:#e0006f\"\u003epink\u003c/span\u003e focus colors\n\t- Indicate enabled options by colored borders instead of checkmarks\n\t- Decorative top border for main elements and bottom border for hovered buttons\n\n#### Translations\n- Currently includes Chinese, English, Dutch, Portuguese and Spanish\n- Instructions for creating new translations can be found in the [Wiki](https://codeberg.org/ltguillaume/music-folder-player/wiki/Translations)\n\n## List of hotkeys\nA list of all the hotkeys can be found in the [Wiki](https://codeberg.org/ltguillaume/music-folder-player/wiki/List-of-hotkeys).\n\n## Installation\nYou can have a test setup running within 2 minutes. For all the details, check the [Wiki](https://codeberg.org/ltguillaume/music-folder-player/wiki).\n\n## Credits\n- Some concepts of this project are based on the excellent [HTML5 Music Player](https://github.com/GM-Script-Writer-62850/HTML5-Music-Player) by [GM-Script-Writer-62850](https://github.com/GM-Script-Writer-62850)\n- The [Barlow font](https://github.com/jpt/barlow) (Regular and Semi Condensed Regular) is used for text\n- The [Foundation icon font](https://zurb.com/playground/foundation-icon-fonts-3) is used for all icons\n- Album art placeholder is based on a [design by CmdRobot](http://fav.me/d7kpm65)\n\nAll credits are due, as well as my sincere thanks!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fltguillaume%2Fmusic-folder-player","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fltguillaume%2Fmusic-folder-player","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fltguillaume%2Fmusic-folder-player/lists"}