noiz/README.md
2026-07-09 10:12:38 +02:00

1.5 KiB
Raw Blame History

noiz://

Logo

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

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 (1s5s)
  • Drag & drop - drop folders or individual files; handles nested directories via the File System Access API (with webkitdirectory fallback)
  • 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.

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.