noiz/README.md

# noiz://

![Logo](./noizmainlogo.png)

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](./noizshot.png)

## Demo
There is a live demo available at [bsd.pm/noiz](https://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 `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.

## Native App (noiz.py)

`noiz.py` is a fully fledged local native application wrapper that runs `noiz://` in its own desktop window using [pywebview](https://pywebview.flowrl.com/). It launches the noiz:// app as a standalone application with native window via Python's webview, rather than running inside a browser tab. noiz.py is (as of now) 8 lines long.

```bash
pip install pywebview && python noiz.py
```