From 60243da9bf42431ee9ee7fb788a675c96f494ce6 Mon Sep 17 00:00:00 2001
From: Armin <armin@cherry>
Date: Sun, 5 Jul 2026 15:12:17 +0200
Subject: [PATCH] add README.md / .gitignore

---
 .gitignore | 34 ++++++++++++++++++++++++++++++++++
 README.md  | 17 +++++++++++++++++
 2 files changed, 51 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..0ae770a
--- /dev/null
+++ b/.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/
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9f143c8
--- /dev/null
+++ b/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.