add README.md / .gitignore

.gitignore

@@ -0,0 +1,34 @@
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+Desktop DB
+Desktop Folder
+.Spotlight-V100
+.Trashes
+Icon?
+._*
+
+# Vim swap files
+*.swp
+*.swo
+*.swn
+*.swm
+*.swl
+.\#*
+\#*\#
+
+# Editor/IDE
+*.sublime-*
+*.sublime-workspace
+*.~
+*~
+.idea/
+.vscode/
+*.sass-cache
+
+# OS files
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/

README.md

@@ -0,0 +1,17 @@
+# noiz://
+
+A browser-based 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.
+
+## 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.