A very simple web based (local) music player
- HTML 100%
|
|
||
|---|---|---|
| .gitignore | add README.md / .gitignore | |
| index.html | document known limitations in README | |
| LICENSE | add license | |
| noizmainlogo.png | update logo | |
| noizshot.png | update screenshot | |
| README.md | Update README | |
noiz://
A browser-based 100%-local audio player with real-time spectrum visualization, VU metering, and comprehensive playlist management. Loaded entirely from a single index.html file - no build step, no server, no dependencies. Plays files from your local machine. That's it.
Obligatory Screenshot
Demo
There is a live demo available at bsd.pm/noiz.
Features
- Real-time FFT spectrum analyzer - smooth animated frequency bars with configurable window function (Hanning / Blackman-Harris) and adjustable peak decay
- VU meter - per-channel level display with peak indicators
- Metadata parsing - reads ID3v1 and ID3v2 tags (title, artist, album, genre, year), plus inline codec info for MP3 and FLAC
- Playlist - sortable by title, artist, filename, length, or genre; supports shuffle and repeat (off / all / one)
- Crossfade - optional gapless transition between tracks (1s–5s)
- Drag & drop - drop folders or individual files; handles nested directories via the File System Access API (with
webkitdirectoryfallback) - Keyboard shortcuts - Space (play/pause), ← (previous), → (next)
Usage
Open index.html in any modern browser. Click +Folder, +Files, or drag audio files onto the window.
Known Limitations
- File path display - When adding individual files via +Files or drag-and-drop, browsers do not expose the full filesystem path for security reasons. Only the filename is shown in the tag editor. Using +Folder (which reads directory structure) provides the relative path within the selected folder.
- Playback interruption on +Folder - Opening the native directory picker suspends the browser's
AudioContext, causing playback to stop. This is a browser-level security restriction (user gesture required for audio resume). Simply press play again after adding files.
noizapp
There is a simple PoC Electron available to make noiz a stand-alone desktop "app": https://codeberg.org/armin/noizapp
License
noiz is released under the MIT license; see LICENSE file.