Welcome to HomeDJukeBox

HomeDJukeBox

This is a minimal audio player for your local music files (mp3 and others, supported by your browser).

The app is just a single webpage with a bunch of helper js-files. Actually it's primary purpose was to cast personal audio collection to Chromecast without an effort - that is the casting is provided by the browser itself.

[!IMPORTANT] The app is based on File System API embedded into browser. This API is disabled by default and must be enabled manually (once) in extended settings, normally located at chrome://flags/#file-system-access-api (may differ in specific browser).

Thanks to the single web-page design, most important advantages are:

• no need to install and setup anything (no app-server, no web-server);
• minimal footprint;
• should work on any device with modern browser;
• doesn't require any access rights (networks, accounts, etc) except for explicit permission for reading collection from disk;
• complete privacy - does not upload and does not share your collection with any parts in Internet;

Main features

• Load tracks by drag-and-drop or via file system dialog boxes;
• Play folders (with subfolders) or "flat" lists of files (from the same folder);
• Shuffle tracks randomly or play them in natural order (how it comes from File System API, that is alphabetically);
• Show MP3 tags (including embedded images);
• Show images, text or html-files with the same names as a track or folder being played (supposed for album arts and lyrics);
• Context search through playlist;
• Spectrogram or oscillogram visualization;
• Mouse and keyboard control;
• Responsive layout;
• Optional automatic volume adjustment between tracks;
• m3u/m3u8-files support;

Images

Initial screen:

Playback example with treeview of playlist, waveform visualization, context search, and lyrics:

Playback example with flat playlist view, spectrogram visualization, and artwork:

Installation

Visit the main branch in HomeDJukeBox repository and grab all files.

Known issues

• text in MP3 tags is displayed incorrectly if stored in locales with non-latin single-byte charsets (such as win-1251);