← back to Mp3 Agentabrams
initial: mp3-agentabrams — grid+list of every MP3 on Mac2
6a16909436290740a6aed80c65a93f64dde53a3b · 2026-05-13 08:16:40 -0700 · steve
358 tracks indexed across ~/Projects/, ~/Videos/, ~/Desktop/, ~/.claude/skills/.
154MB total. Express on port 9696 (override MP3_PORT).
Stack:
scan-mp3s.js walks SCAN_ROOTS, writes manifest.json (gitignored)
server.js /api/manifest, /api/refresh (re-scan), /audio?id=<id> with
Range support, /healthz, static public/.
index.html grid + list toggle, density slider (2-10 cols), sort
(Newest/Oldest/Title/Size/Duration/Source), text + source
filter, pseudo-waveform card art, inline range-aware player
bar at bottom. All controls persist via localStorage mp3aa.*
and hydrate BEFORE first render per Steve's standing rule.
Paths never appear in URLs — every track is referenced by stable sha1-12
id, so the filesystem layout is hidden from the frontend.
ffprobe duration probe gated by PROBE_DURATIONS=1 (first scan ran with
=0 for speed; durations show as -- in the UI until re-scan with
ffprobe enabled).
Next: DNS hookup at mp3.agentabrams.com (same pattern as
videos.agentabrams.com), optional auth gate if exposed publicly.
Files touched
A .gitignoreA README.mdA package-lock.jsonA package.jsonA public/index.htmlA scan-mp3s.jsA server.js
Diff
commit 6a16909436290740a6aed80c65a93f64dde53a3b
Author: steve <steve@designerwallcoverings.com>
Date: Wed May 13 08:16:40 2026 -0700
initial: mp3-agentabrams — grid+list of every MP3 on Mac2
358 tracks indexed across ~/Projects/, ~/Videos/, ~/Desktop/, ~/.claude/skills/.
154MB total. Express on port 9696 (override MP3_PORT).
Stack:
scan-mp3s.js walks SCAN_ROOTS, writes manifest.json (gitignored)
server.js /api/manifest, /api/refresh (re-scan), /audio?id=<id> with
Range support, /healthz, static public/.
index.html grid + list toggle, density slider (2-10 cols), sort
(Newest/Oldest/Title/Size/Duration/Source), text + source
filter, pseudo-waveform card art, inline range-aware player
bar at bottom. All controls persist via localStorage mp3aa.*
and hydrate BEFORE first render per Steve's standing rule.
Paths never appear in URLs — every track is referenced by stable sha1-12
id, so the filesystem layout is hidden from the frontend.
ffprobe duration probe gated by PROBE_DURATIONS=1 (first scan ran with
=0 for speed; durations show as -- in the UI until re-scan with
ffprobe enabled).
Next: DNS hookup at mp3.agentabrams.com (same pattern as
videos.agentabrams.com), optional auth gate if exposed publicly.
---
.gitignore | 7 +
README.md | 60 ++++
package-lock.json | 830 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
package.json | 17 ++
public/index.html | 459 ++++++++++++++++++++++++++++++
scan-mp3s.js | 136 +++++++++
server.js | 80 ++++++
7 files changed, 1589 insertions(+)
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..4053ebe
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,7 @@
+node_modules/
+.env*
+tmp/
+*.log
+.DS_Store
+manifest.json
+data/
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5924015
--- /dev/null
+++ b/README.md
@@ -0,0 +1,60 @@
+# mp3-agentabrams
+
+Every MP3 recording ever made on Steve's Mac2, served as a grid + list with sort, density slider, and inline player. Future home: `mp3.agentabrams.com` (DNS hookup pending).
+
+> 358 tracks indexed at first scan · 154 MB total · spans `~/Projects/`, `~/Videos/`, `~/Desktop/`, `~/.claude/skills/`
+
+## Stack
+
+- Express 5 on port **9696** (override with `MP3_PORT`)
+- Static frontend at `public/index.html` (no build step)
+- `scan-mp3s.js` walks the disk, writes `manifest.json` (gitignored)
+
+## Run
+
+```bash
+npm run scan # rebuild manifest.json
+npm start # http://127.0.0.1:9696
+```
+
+In the UI, click "refresh manifest" to re-scan from the browser.
+
+## API
+
+| Route | Verb | Notes |
+| --- | --- | --- |
+| `/` | GET | static UI |
+| `/api/manifest` | GET | full JSON of indexed tracks |
+| `/api/refresh` | POST | re-runs scan-mp3s.js |
+| `/audio?id=<id>` | GET | streams MP3 by manifest id (range-aware) |
+| `/healthz` | GET | 200 if `manifest.count > 0`, else 503 |
+
+Paths never appear in URLs — every track is referenced by stable sha1-prefix id.
+
+## Scan config
+
+Defaults to scanning these roots (`SCAN_ROOTS` env overrides, comma-separated):
+
+```
+~/Projects, ~/Videos, ~/Desktop, ~/.claude/skills
+```
+
+Excluded substrings (in any path part): `/node_modules/`, `/.git/`, `/.Trash/`, `/Library/Caches/`, `/kamatera-mirror/`, `/.cache/`, `/.next/`, `/dist/`, `/build/`.
+
+`ffprobe` is opt-in (`PROBE_DURATIONS=1` env). It adds ~30-60s to the scan for 358 files; durations show as `—` when off. First scan ran with `PROBE_DURATIONS=0` for speed.
+
+## UI features (per Steve's standing rules)
+
+- **Sort `<select>`**: Newest / Oldest / Title A→Z / Title Z→A / Size ↑↓ / Duration ↑↓ / Source A→Z
+- **Density slider** (2–10 columns) — drives `--cols` CSS var on `<main.grid>`
+- **View toggle**: grid ↔ list
+- **Source filter `<select>`** — auto-populated from unique parent dirs
+- **Text filter** — substring match over name + parent + parent2
+- **Persisted state**: all controls hydrate from `localStorage` keys under `mp3aa.*` before the first render
+
+## Next steps (gated on Steve)
+
+1. **DNS hookup** — point `mp3.agentabrams.com` at this port via Cloudflare + the same reverse-proxy pattern Steve uses for `videos.agentabrams.com` / `admin.agentabrams.com`.
+2. **Duration probe** — run once with `PROBE_DURATIONS=1` after `brew install ffmpeg` (probably already installed).
+3. **Auto-refresh watcher** — extend `videos-agentabrams-worker` to also re-scan when new MP3s land in any of the SCAN_ROOTS.
+4. **Auth** — if exposed publicly, add the same auth gate as `admin.agentabrams.com` (subagent's pattern).
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 0000000..2eea51c
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,830 @@
+{
+ "name": "mp3-agentabrams",
+ "version": "0.1.0",
+ "lockfileVersion": 3,
+ "requires": true,
+ "packages": {
+ "": {
+ "name": "mp3-agentabrams",
+ "version": "0.1.0",
+ "license": "UNLICENSED",
+ "dependencies": {
+ "express": "^5.2.1"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/accepts": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
+ "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==",
+ "license": "MIT",
+ "dependencies": {
+ "mime-types": "^3.0.0",
+ "negotiator": "^1.0.0"
+ },
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/body-parser": {
+ "version": "2.2.2",
+ "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.2.2.tgz",
+ "integrity": "sha512-oP5VkATKlNwcgvxi0vM0p/D3n2C3EReYVX+DNYs5TjZFn/oQt2j+4sVJtSMr18pdRr8wjTcBl6LoV+FUwzPmNA==",
+ "license": "MIT",
+ "dependencies": {
+ "bytes": "^3.1.2",
+ "content-type": "^1.0.5",
+ "debug": "^4.4.3",
+ "http-errors": "^2.0.0",
+ "iconv-lite": "^0.7.0",
+ "on-finished": "^2.4.1",
+ "qs": "^6.14.1",
+ "raw-body": "^3.0.1",
+ "type-is": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=18"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/bytes": {
+ "version": "3.1.2",
+ "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+ "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/call-bind-apply-helpers": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+ "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+ "license": "MIT",
+ "dependencies": {
+ "es-errors": "^1.3.0",
+ "function-bind": "^1.1.2"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/call-bound": {
+ "version": "1.0.4",
+ "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+ "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+ "license": "MIT",
+ "dependencies": {
+ "call-bind-apply-helpers": "^1.0.2",
+ "get-intrinsic": "^1.3.0"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/content-disposition": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.1.0.tgz",
+ "integrity": "sha512-5jRCH9Z/+DRP7rkvY83B+yGIGX96OYdJmzngqnw2SBSxqCFPd0w2km3s5iawpGX8krnwSGmF0FW5Nhr0Hfai3g==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=18"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/content-type": {
+ "version": "1.0.5",
+ "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
+ "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/cookie": {
+ "version": "0.7.2",
+ "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+ "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/cookie-signature": {
+ "version": "1.2.2",
+ "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.2.2.tgz",
+ "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=6.6.0"
+ }
+ },
+ "node_modules/debug": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+ "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+ "license": "MIT",
+ "dependencies": {
+ "ms": "^2.1.3"
+ },
+ "engines": {
+ "node": ">=6.0"
+ },
+ "peerDependenciesMeta": {
+ "supports-color": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/depd": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+ "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/dunder-proto": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+ "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+ "license": "MIT",
+ "dependencies": {
+ "call-bind-apply-helpers": "^1.0.1",
+ "es-errors": "^1.3.0",
+ "gopd": "^1.2.0"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/ee-first": {
+ "version": "1.1.1",
+ "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+ "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
+ "license": "MIT"
+ },
+ "node_modules/encodeurl": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+ "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/es-define-property": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+ "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/es-errors": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+ "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/es-object-atoms": {
+ "version": "1.1.1",
+ "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+ "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+ "license": "MIT",
+ "dependencies": {
+ "es-errors": "^1.3.0"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/escape-html": {
+ "version": "1.0.3",
+ "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+ "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+ "license": "MIT"
+ },
+ "node_modules/etag": {
+ "version": "1.8.1",
+ "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+ "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/express": {
+ "version": "5.2.1",
+ "resolved": "https://registry.npmjs.org/express/-/express-5.2.1.tgz",
+ "integrity": "sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==",
+ "license": "MIT",
+ "dependencies": {
+ "accepts": "^2.0.0",
+ "body-parser": "^2.2.1",
+ "content-disposition": "^1.0.0",
+ "content-type": "^1.0.5",
+ "cookie": "^0.7.1",
+ "cookie-signature": "^1.2.1",
+ "debug": "^4.4.0",
+ "depd": "^2.0.0",
+ "encodeurl": "^2.0.0",
+ "escape-html": "^1.0.3",
+ "etag": "^1.8.1",
+ "finalhandler": "^2.1.0",
+ "fresh": "^2.0.0",
+ "http-errors": "^2.0.0",
+ "merge-descriptors": "^2.0.0",
+ "mime-types": "^3.0.0",
+ "on-finished": "^2.4.1",
+ "once": "^1.4.0",
+ "parseurl": "^1.3.3",
+ "proxy-addr": "^2.0.7",
+ "qs": "^6.14.0",
+ "range-parser": "^1.2.1",
+ "router": "^2.2.0",
+ "send": "^1.1.0",
+ "serve-static": "^2.2.0",
+ "statuses": "^2.0.1",
+ "type-is": "^2.0.1",
+ "vary": "^1.1.2"
+ },
+ "engines": {
+ "node": ">= 18"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/finalhandler": {
+ "version": "2.1.1",
+ "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz",
+ "integrity": "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==",
+ "license": "MIT",
+ "dependencies": {
+ "debug": "^4.4.0",
+ "encodeurl": "^2.0.0",
+ "escape-html": "^1.0.3",
+ "on-finished": "^2.4.1",
+ "parseurl": "^1.3.3",
+ "statuses": "^2.0.1"
+ },
+ "engines": {
+ "node": ">= 18.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/forwarded": {
+ "version": "0.2.0",
+ "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
+ "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/fresh": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz",
+ "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/function-bind": {
+ "version": "1.1.2",
+ "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+ "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+ "license": "MIT",
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/get-intrinsic": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+ "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+ "license": "MIT",
+ "dependencies": {
+ "call-bind-apply-helpers": "^1.0.2",
+ "es-define-property": "^1.0.1",
+ "es-errors": "^1.3.0",
+ "es-object-atoms": "^1.1.1",
+ "function-bind": "^1.1.2",
+ "get-proto": "^1.0.1",
+ "gopd": "^1.2.0",
+ "has-symbols": "^1.1.0",
+ "hasown": "^2.0.2",
+ "math-intrinsics": "^1.1.0"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/get-proto": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+ "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+ "license": "MIT",
+ "dependencies": {
+ "dunder-proto": "^1.0.1",
+ "es-object-atoms": "^1.0.0"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/gopd": {
+ "version": "1.2.0",
+ "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+ "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/has-symbols": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+ "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/hasown": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.3.tgz",
+ "integrity": "sha512-ej4AhfhfL2Q2zpMmLo7U1Uv9+PyhIZpgQLGT1F9miIGmiCJIoCgSmczFdrc97mWT4kVY72KA+WnnhJ5pghSvSg==",
+ "license": "MIT",
+ "dependencies": {
+ "function-bind": "^1.1.2"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/http-errors": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
+ "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
+ "license": "MIT",
+ "dependencies": {
+ "depd": "~2.0.0",
+ "inherits": "~2.0.4",
+ "setprototypeof": "~1.2.0",
+ "statuses": "~2.0.2",
+ "toidentifier": "~1.0.1"
+ },
+ "engines": {
+ "node": ">= 0.8"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/iconv-lite": {
+ "version": "0.7.2",
+ "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.2.tgz",
+ "integrity": "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw==",
+ "license": "MIT",
+ "dependencies": {
+ "safer-buffer": ">= 2.1.2 < 3.0.0"
+ },
+ "engines": {
+ "node": ">=0.10.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/inherits": {
+ "version": "2.0.4",
+ "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+ "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+ "license": "ISC"
+ },
+ "node_modules/ipaddr.js": {
+ "version": "1.9.1",
+ "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+ "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.10"
+ }
+ },
+ "node_modules/is-promise": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz",
+ "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==",
+ "license": "MIT"
+ },
+ "node_modules/math-intrinsics": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+ "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/media-typer": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.0.tgz",
+ "integrity": "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/merge-descriptors": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
+ "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=18"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/mime-db": {
+ "version": "1.54.0",
+ "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
+ "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/mime-types": {
+ "version": "3.0.2",
+ "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz",
+ "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==",
+ "license": "MIT",
+ "dependencies": {
+ "mime-db": "^1.54.0"
+ },
+ "engines": {
+ "node": ">=18"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/ms": {
+ "version": "2.1.3",
+ "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+ "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+ "license": "MIT"
+ },
+ "node_modules/negotiator": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.0.0.tgz",
+ "integrity": "sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/object-inspect": {
+ "version": "1.13.4",
+ "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+ "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/on-finished": {
+ "version": "2.4.1",
+ "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+ "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+ "license": "MIT",
+ "dependencies": {
+ "ee-first": "1.1.1"
+ },
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/once": {
+ "version": "1.4.0",
+ "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+ "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+ "license": "ISC",
+ "dependencies": {
+ "wrappy": "1"
+ }
+ },
+ "node_modules/parseurl": {
+ "version": "1.3.3",
+ "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+ "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/path-to-regexp": {
+ "version": "8.4.2",
+ "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.2.tgz",
+ "integrity": "sha512-qRcuIdP69NPm4qbACK+aDogI5CBDMi1jKe0ry5rSQJz8JVLsC7jV8XpiJjGRLLol3N+R5ihGYcrPLTno6pAdBA==",
+ "license": "MIT",
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/proxy-addr": {
+ "version": "2.0.7",
+ "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
+ "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+ "license": "MIT",
+ "dependencies": {
+ "forwarded": "0.2.0",
+ "ipaddr.js": "1.9.1"
+ },
+ "engines": {
+ "node": ">= 0.10"
+ }
+ },
+ "node_modules/qs": {
+ "version": "6.15.1",
+ "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.1.tgz",
+ "integrity": "sha512-6YHEFRL9mfgcAvql/XhwTvf5jKcOiiupt2FiJxHkiX1z4j7WL8J/jRHYLluORvc1XxB5rV20KoeK00gVJamspg==",
+ "license": "BSD-3-Clause",
+ "dependencies": {
+ "side-channel": "^1.1.0"
+ },
+ "engines": {
+ "node": ">=0.6"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/range-parser": {
+ "version": "1.2.1",
+ "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
+ "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/raw-body": {
+ "version": "3.0.2",
+ "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-3.0.2.tgz",
+ "integrity": "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==",
+ "license": "MIT",
+ "dependencies": {
+ "bytes": "~3.1.2",
+ "http-errors": "~2.0.1",
+ "iconv-lite": "~0.7.0",
+ "unpipe": "~1.0.0"
+ },
+ "engines": {
+ "node": ">= 0.10"
+ }
+ },
+ "node_modules/router": {
+ "version": "2.2.0",
+ "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz",
+ "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==",
+ "license": "MIT",
+ "dependencies": {
+ "debug": "^4.4.0",
+ "depd": "^2.0.0",
+ "is-promise": "^4.0.0",
+ "parseurl": "^1.3.3",
+ "path-to-regexp": "^8.0.0"
+ },
+ "engines": {
+ "node": ">= 18"
+ }
+ },
+ "node_modules/safer-buffer": {
+ "version": "2.1.2",
+ "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+ "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+ "license": "MIT"
+ },
+ "node_modules/send": {
+ "version": "1.2.1",
+ "resolved": "https://registry.npmjs.org/send/-/send-1.2.1.tgz",
+ "integrity": "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==",
+ "license": "MIT",
+ "dependencies": {
+ "debug": "^4.4.3",
+ "encodeurl": "^2.0.0",
+ "escape-html": "^1.0.3",
+ "etag": "^1.8.1",
+ "fresh": "^2.0.0",
+ "http-errors": "^2.0.1",
+ "mime-types": "^3.0.2",
+ "ms": "^2.1.3",
+ "on-finished": "^2.4.1",
+ "range-parser": "^1.2.1",
+ "statuses": "^2.0.2"
+ },
+ "engines": {
+ "node": ">= 18"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/serve-static": {
+ "version": "2.2.1",
+ "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.1.tgz",
+ "integrity": "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==",
+ "license": "MIT",
+ "dependencies": {
+ "encodeurl": "^2.0.0",
+ "escape-html": "^1.0.3",
+ "parseurl": "^1.3.3",
+ "send": "^1.2.0"
+ },
+ "engines": {
+ "node": ">= 18"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/setprototypeof": {
+ "version": "1.2.0",
+ "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+ "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+ "license": "ISC"
+ },
+ "node_modules/side-channel": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
+ "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
+ "license": "MIT",
+ "dependencies": {
+ "es-errors": "^1.3.0",
+ "object-inspect": "^1.13.3",
+ "side-channel-list": "^1.0.0",
+ "side-channel-map": "^1.0.1",
+ "side-channel-weakmap": "^1.0.2"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/side-channel-list": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz",
+ "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==",
+ "license": "MIT",
+ "dependencies": {
+ "es-errors": "^1.3.0",
+ "object-inspect": "^1.13.4"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/side-channel-map": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+ "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+ "license": "MIT",
+ "dependencies": {
+ "call-bound": "^1.0.2",
+ "es-errors": "^1.3.0",
+ "get-intrinsic": "^1.2.5",
+ "object-inspect": "^1.13.3"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/side-channel-weakmap": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+ "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+ "license": "MIT",
+ "dependencies": {
+ "call-bound": "^1.0.2",
+ "es-errors": "^1.3.0",
+ "get-intrinsic": "^1.2.5",
+ "object-inspect": "^1.13.3",
+ "side-channel-map": "^1.0.1"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/statuses": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
+ "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/toidentifier": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+ "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.6"
+ }
+ },
+ "node_modules/type-is": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.0.1.tgz",
+ "integrity": "sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw==",
+ "license": "MIT",
+ "dependencies": {
+ "content-type": "^1.0.5",
+ "media-typer": "^1.1.0",
+ "mime-types": "^3.0.0"
+ },
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/unpipe": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+ "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/vary": {
+ "version": "1.1.2",
+ "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+ "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/wrappy": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+ "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+ "license": "ISC"
+ }
+ }
+}
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..71efef2
--- /dev/null
+++ b/package.json
@@ -0,0 +1,17 @@
+{
+ "name": "mp3-agentabrams",
+ "version": "0.1.0",
+ "description": "Grid + list of every MP3 ever made on Steve's Mac2, served at mp3.agentabrams.com",
+ "private": true,
+ "type": "commonjs",
+ "scripts": {
+ "scan": "node scan-mp3s.js",
+ "start": "node server.js"
+ },
+ "dependencies": {
+ "express": "^5.2.1"
+ },
+ "engines": { "node": ">=18" },
+ "author": "Steve Abrams",
+ "license": "UNLICENSED"
+}
diff --git a/public/index.html b/public/index.html
new file mode 100644
index 0000000..34e142e
--- /dev/null
+++ b/public/index.html
@@ -0,0 +1,459 @@
+<!doctype html>
+<html lang="en">
+<head>
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <title>mp3.agentabrams.com · every recording, one grid</title>
+ <style>
+ :root {
+ --bg: #0a0a0a;
+ --panel: #111;
+ --panel2: #161616;
+ --fg: #e6e6e6;
+ --dim: #888;
+ --dim2: #5a5a5a;
+ --accent: #d4af37; /* gold */
+ --accent2: #4ec9b0; /* teal */
+ --line: #1f1f1f;
+ --cols: 5; /* density slider drives this */
+ }
+ html, body {
+ margin: 0; padding: 0;
+ background: var(--bg); color: var(--fg);
+ font: 14px/1.45 -apple-system, BlinkMacSystemFont, "SF Pro Text", system-ui, sans-serif;
+ }
+ a { color: var(--accent); text-decoration: none; }
+ header {
+ padding: 18px 22px 14px;
+ border-bottom: 1px solid var(--line);
+ background: linear-gradient(180deg, #131313, #0a0a0a);
+ display: flex; align-items: baseline; gap: 16px; flex-wrap: wrap;
+ }
+ h1 {
+ margin: 0;
+ font: 600 18px/1 -apple-system, BlinkMacSystemFont, system-ui, sans-serif;
+ letter-spacing: .5px;
+ }
+ h1 .gold { color: var(--accent); font-weight: 700; }
+ .stats { color: var(--dim); font-size: 12px; }
+ .stats b { color: var(--fg); font-weight: 600; margin-right: 4px; }
+
+ .ctrl {
+ padding: 10px 22px;
+ border-bottom: 1px solid var(--line);
+ display: flex; gap: 16px; align-items: center; flex-wrap: wrap;
+ background: var(--panel);
+ font-size: 12px;
+ }
+ .ctrl label { color: var(--dim); display: flex; align-items: center; gap: 6px; }
+ .ctrl input[type="text"] {
+ background: var(--bg); color: var(--fg);
+ border: 1px solid var(--line); border-radius: 4px;
+ padding: 6px 10px; font: inherit; min-width: 240px;
+ }
+ .ctrl input[type="text"]:focus { border-color: var(--accent2); outline: none; }
+ .ctrl select {
+ background: var(--bg); color: var(--fg);
+ border: 1px solid var(--line); border-radius: 4px;
+ padding: 6px 10px; font: inherit;
+ }
+ .ctrl input[type="range"] { width: 130px; }
+ .view-toggle {
+ display: flex; gap: 0;
+ border: 1px solid var(--line); border-radius: 4px; overflow: hidden;
+ }
+ .view-toggle button {
+ background: var(--bg); color: var(--dim);
+ border: 0; padding: 6px 10px; font: inherit; cursor: pointer;
+ border-right: 1px solid var(--line);
+ }
+ .view-toggle button:last-child { border-right: 0; }
+ .view-toggle button.active { background: var(--accent); color: #000; font-weight: 600; }
+
+ /* ---------- GRID VIEW ---------- */
+ main.grid {
+ display: grid;
+ grid-template-columns: repeat(var(--cols), 1fr);
+ gap: 12px;
+ padding: 14px;
+ }
+ .card {
+ background: var(--panel2);
+ border: 1px solid var(--line);
+ border-radius: 8px;
+ padding: 10px 12px 8px;
+ display: flex; flex-direction: column; gap: 6px;
+ transition: border-color .15s ease, transform .12s ease;
+ cursor: pointer;
+ }
+ .card:hover { border-color: var(--accent); }
+ .card.playing { border-color: var(--accent2); box-shadow: 0 0 0 1px var(--accent2) inset; }
+ .card .ico {
+ aspect-ratio: 1 / 1.15;
+ background:
+ radial-gradient(circle at 30% 30%, #2a2a2a 0%, #161616 70%),
+ linear-gradient(180deg, #1f1f1f, #0a0a0a);
+ border-radius: 6px;
+ position: relative;
+ display: flex; align-items: center; justify-content: center;
+ overflow: hidden;
+ }
+ .card .ico::after {
+ content: '▶';
+ position: absolute; inset: 0;
+ display: flex; align-items: center; justify-content: center;
+ color: var(--accent); font-size: 36px;
+ opacity: .85; transition: transform .15s ease;
+ }
+ .card:hover .ico::after { transform: scale(1.15); color: #fff; }
+ .card.playing .ico::after { content: '⏸'; color: var(--accent2); }
+ .wave {
+ position: absolute; inset: 60% 8% 12% 8%;
+ display: flex; align-items: end; gap: 2px;
+ opacity: .55;
+ }
+ .wave span {
+ flex: 1; background: var(--accent);
+ border-radius: 1px;
+ }
+ .card .title {
+ font: 600 13px/1.3 -apple-system, system-ui, sans-serif;
+ color: var(--fg);
+ overflow: hidden; text-overflow: ellipsis;
+ display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical;
+ min-height: 2.6em;
+ }
+ .card .meta {
+ font-size: 11px; color: var(--dim);
+ display: flex; gap: 8px; flex-wrap: wrap;
+ }
+ .card .src {
+ font-size: 10px; color: var(--accent);
+ text-transform: uppercase; letter-spacing: .5px;
+ overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+ }
+
+ /* ---------- LIST VIEW ---------- */
+ main.list {
+ padding: 0 14px 14px;
+ }
+ table.list {
+ width: 100%;
+ border-collapse: collapse;
+ font-size: 13px;
+ }
+ table.list th {
+ text-align: left;
+ padding: 10px 8px;
+ border-bottom: 1px solid var(--line);
+ color: var(--dim);
+ font-weight: 500;
+ font-size: 11px;
+ text-transform: uppercase;
+ letter-spacing: .5px;
+ position: sticky; top: 0;
+ background: var(--bg);
+ }
+ table.list td {
+ padding: 8px;
+ border-bottom: 1px solid var(--line);
+ vertical-align: middle;
+ }
+ table.list tr { cursor: pointer; }
+ table.list tr:hover td { background: var(--panel2); }
+ table.list tr.playing td { background: rgba(78,201,176,.08); }
+ table.list .name { color: var(--fg); font-weight: 500; }
+ table.list .src-cell { color: var(--accent); font-size: 11px; }
+ table.list .num { font-variant-numeric: tabular-nums; color: var(--dim); }
+
+ /* ---------- PLAYER BAR ---------- */
+ .player {
+ position: fixed; bottom: 0; left: 0; right: 0;
+ background: var(--panel);
+ border-top: 1px solid var(--accent);
+ padding: 10px 16px;
+ display: flex; gap: 14px; align-items: center;
+ z-index: 100;
+ transform: translateY(100%);
+ transition: transform .25s ease;
+ }
+ .player.active { transform: translateY(0); }
+ .player .now {
+ flex: 1;
+ overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+ }
+ .player .now b { color: var(--accent); margin-right: 8px; }
+ .player audio { flex: 2; max-width: 600px; }
+
+ .empty {
+ padding: 60px 22px;
+ color: var(--dim);
+ text-align: center;
+ }
+ .empty b { color: var(--accent); }
+ </style>
+</head>
+<body>
+ <header>
+ <h1>mp3<span class="gold">.agentabrams</span>.com</h1>
+ <span class="stats">
+ <b id="stat-count">0</b>tracks
+ <b id="stat-size" style="margin-left:14px">0</b>MB
+ <b id="stat-hours" style="margin-left:14px">0h</b>total
+ <span style="margin-left:14px; color: var(--dim2);">manifest: <span id="stat-gen">—</span></span>
+ </span>
+ </header>
+
+ <div class="ctrl">
+ <input id="filter" type="text" placeholder="filter by name or source…" autocomplete="off" />
+
+ <label>
+ sort:
+ <select id="sort">
+ <option value="newest">Newest</option>
+ <option value="oldest">Oldest</option>
+ <option value="name">Title A→Z</option>
+ <option value="name-desc">Title Z→A</option>
+ <option value="size">Size ↑</option>
+ <option value="size-desc">Size ↓</option>
+ <option value="duration">Duration ↑</option>
+ <option value="duration-desc">Duration ↓</option>
+ <option value="source">Source A→Z</option>
+ </select>
+ </label>
+
+ <label>
+ source:
+ <select id="source-filter"><option value="">(all)</option></select>
+ </label>
+
+ <label>
+ density:
+ <input id="density" type="range" min="2" max="10" step="1" />
+ <span id="density-val" class="num" style="color:var(--dim); font-size:11px; min-width:18px;">5</span>
+ </label>
+
+ <div class="view-toggle">
+ <button data-view="grid" class="active">grid</button>
+ <button data-view="list">list</button>
+ </div>
+
+ <span style="margin-left:auto; color: var(--dim); font-size: 11px;">
+ <span id="shown">—</span> shown · <a href="#" id="refresh">refresh manifest</a>
+ </span>
+ </div>
+
+ <main id="root" class="grid"><div class="empty">loading…</div></main>
+
+ <div class="player" id="player">
+ <span class="now"><b>—</b><span id="now-title">nothing playing</span></span>
+ <audio id="audio" controls preload="none"></audio>
+ </div>
+
+ <script>
+ const root = document.getElementById('root');
+ const filterEl = document.getElementById('filter');
+ const sortEl = document.getElementById('sort');
+ const srcEl = document.getElementById('source-filter');
+ const densityEl = document.getElementById('density');
+ const densityVal = document.getElementById('density-val');
+ const viewBtns = document.querySelectorAll('.view-toggle button');
+ const stats = {
+ count: document.getElementById('stat-count'),
+ size: document.getElementById('stat-size'),
+ hours: document.getElementById('stat-hours'),
+ gen: document.getElementById('stat-gen'),
+ shown: document.getElementById('shown'),
+ };
+ const player = document.getElementById('player');
+ const audio = document.getElementById('audio');
+ const nowTitle = document.getElementById('now-title');
+
+ // -------- persistence ----------
+ const LS_PREFIX = 'mp3aa.';
+ function load(k, d) { try { const v = localStorage.getItem(LS_PREFIX + k); return v === null ? d : JSON.parse(v); } catch { return d; } }
+ function save(k, v) { try { localStorage.setItem(LS_PREFIX + k, JSON.stringify(v)); } catch {} }
+
+ // hydrate BEFORE first render
+ let view = load('view', 'grid');
+ let density = load('density', 5);
+ let sortMode = load('sort', 'newest');
+ let srcFilter = load('src', '');
+ let textFilter = load('filter', '');
+ filterEl.value = textFilter;
+ sortEl.value = sortMode;
+ densityEl.value = density;
+ densityVal.textContent = density;
+ document.documentElement.style.setProperty('--cols', density);
+ for (const b of viewBtns) b.classList.toggle('active', b.dataset.view === view);
+ root.className = view;
+
+ // -------- data ----------
+ let items = [];
+ let currentlyPlayingId = null;
+
+ function fmtSize(b) {
+ if (b < 1024) return b + ' B';
+ if (b < 1024 * 1024) return (b / 1024).toFixed(0) + ' KB';
+ return (b / (1024 * 1024)).toFixed(1) + ' MB';
+ }
+ function fmtDur(s) {
+ if (s == null) return '—';
+ const m = Math.floor(s / 60);
+ const r = Math.floor(s % 60);
+ return m + ':' + String(r).padStart(2, '0');
+ }
+ function fmtDate(ms) {
+ const d = new Date(ms);
+ return d.toISOString().slice(0, 16).replace('T', ' ');
+ }
+
+ // tiny pseudo-waveform decoration — deterministic per id
+ function waveHtml(id) {
+ let seed = 0; for (const c of id) seed = (seed * 31 + c.charCodeAt(0)) & 0xffffffff;
+ const bars = [];
+ for (let i = 0; i < 16; i++) {
+ seed = (seed * 1103515245 + 12345) & 0x7fffffff;
+ const h = 15 + (seed % 65);
+ bars.push(`<span style="height:${h}%"></span>`);
+ }
+ return `<div class="wave">${bars.join('')}</div>`;
+ }
+
+ function applyFilters(arr) {
+ const q = textFilter.trim().toLowerCase();
+ let out = arr;
+ if (q) {
+ out = out.filter((it) =>
+ it.name.toLowerCase().includes(q) ||
+ (it.parent || '').toLowerCase().includes(q) ||
+ (it.parent2 || '').toLowerCase().includes(q)
+ );
+ }
+ if (srcFilter) out = out.filter((it) => it.parent === srcFilter || it.parent2 === srcFilter);
+ switch (sortMode) {
+ case 'oldest': out = [...out].sort((a, b) => a.mtime - b.mtime); break;
+ case 'name': out = [...out].sort((a, b) => a.name.localeCompare(b.name)); break;
+ case 'name-desc': out = [...out].sort((a, b) => b.name.localeCompare(a.name)); break;
+ case 'size': out = [...out].sort((a, b) => a.size - b.size); break;
+ case 'size-desc': out = [...out].sort((a, b) => b.size - a.size); break;
+ case 'duration': out = [...out].sort((a, b) => (a.duration ?? 1e9) - (b.duration ?? 1e9)); break;
+ case 'duration-desc':out = [...out].sort((a, b) => (b.duration ?? 0) - (a.duration ?? 0)); break;
+ case 'source': out = [...out].sort((a, b) => (a.parent || '').localeCompare(b.parent || '')); break;
+ default: out = [...out].sort((a, b) => b.mtime - a.mtime); /* newest */
+ }
+ return out;
+ }
+
+ function render() {
+ const arr = applyFilters(items);
+ stats.shown.textContent = arr.length;
+ if (!arr.length) {
+ root.innerHTML = `<div class="empty">no MP3s match. <b>filter:</b> "${textFilter}" / <b>source:</b> "${srcFilter || 'all'}"</div>`;
+ return;
+ }
+ if (view === 'grid') {
+ root.className = 'grid';
+ root.innerHTML = arr.map((it) => `
+ <div class="card${it.id === currentlyPlayingId ? ' playing' : ''}" data-id="${it.id}" title="${escapeAttr(it.path)}">
+ <div class="ico">${waveHtml(it.id)}</div>
+ <div class="title">${escapeHtml(it.name)}</div>
+ <div class="meta">
+ <span>${fmtDur(it.duration)}</span>
+ <span>${fmtSize(it.size)}</span>
+ </div>
+ <div class="src">${escapeHtml(it.parent || '?')}</div>
+ <div class="meta" style="font-size:10px">${fmtDate(it.mtime)}</div>
+ </div>
+ `).join('');
+ } else {
+ root.className = 'list';
+ root.innerHTML = `
+ <table class="list">
+ <thead><tr>
+ <th>Title</th><th>Source</th><th class="num">Dur</th><th class="num">Size</th><th>Date</th>
+ </tr></thead>
+ <tbody>
+ ${arr.map((it) => `
+ <tr class="${it.id === currentlyPlayingId ? 'playing' : ''}" data-id="${it.id}">
+ <td class="name">${escapeHtml(it.name)}</td>
+ <td class="src-cell">${escapeHtml(it.parent || '?')}</td>
+ <td class="num">${fmtDur(it.duration)}</td>
+ <td class="num">${fmtSize(it.size)}</td>
+ <td class="num">${fmtDate(it.mtime)}</td>
+ </tr>`).join('')}
+ </tbody>
+ </table>`;
+ }
+ }
+ function escapeHtml(s) { return String(s).replace(/[&<>"]/g, (c) => ({'&':'&','<':'<','>':'>','"':'"'}[c])); }
+ function escapeAttr(s) { return escapeHtml(s).replace(/'/g, '''); }
+
+ function play(id) {
+ const item = items.find((x) => x.id === id);
+ if (!item) return;
+ currentlyPlayingId = id;
+ audio.src = '/audio?id=' + encodeURIComponent(id);
+ audio.play();
+ nowTitle.textContent = item.name + ' · ' + (item.parent || '');
+ player.classList.add('active');
+ render();
+ }
+
+ root.addEventListener('click', (e) => {
+ const el = e.target.closest('[data-id]');
+ if (!el) return;
+ const id = el.dataset.id;
+ if (id === currentlyPlayingId && !audio.paused) { audio.pause(); currentlyPlayingId = null; render(); }
+ else play(id);
+ });
+ audio.addEventListener('ended', () => { currentlyPlayingId = null; render(); });
+
+ filterEl.addEventListener('input', () => { textFilter = filterEl.value; save('filter', textFilter); render(); });
+ sortEl.addEventListener('change', () => { sortMode = sortEl.value; save('sort', sortMode); render(); });
+ srcEl.addEventListener('change', () => { srcFilter = srcEl.value; save('src', srcFilter); render(); });
+ densityEl.addEventListener('input', () => {
+ density = +densityEl.value;
+ densityVal.textContent = density;
+ document.documentElement.style.setProperty('--cols', density);
+ save('density', density);
+ });
+ for (const b of viewBtns) {
+ b.addEventListener('click', () => {
+ view = b.dataset.view;
+ for (const x of viewBtns) x.classList.toggle('active', x === b);
+ save('view', view);
+ render();
+ });
+ }
+ document.getElementById('refresh').addEventListener('click', async (e) => {
+ e.preventDefault();
+ const a = e.target;
+ a.textContent = 'scanning…';
+ try {
+ const r = await fetch('/api/refresh', { method: 'POST' });
+ const j = await r.json();
+ a.textContent = j.ok ? `refreshed (${j.count})` : 'refresh error';
+ await loadManifest();
+ } catch { a.textContent = 'refresh failed'; }
+ setTimeout(() => { a.textContent = 'refresh manifest'; }, 2200);
+ });
+
+ async function loadManifest() {
+ const r = await fetch('/api/manifest');
+ const m = await r.json();
+ items = m.items || [];
+ stats.count.textContent = items.length.toLocaleString();
+ stats.size.textContent = ((m.totalSizeBytes || 0) / 1024 / 1024).toFixed(0).toLocaleString();
+ const totalSec = items.reduce((a, b) => a + (b.duration || 0), 0);
+ stats.hours.textContent = (totalSec / 3600).toFixed(1) + 'h';
+ stats.gen.textContent = m.generatedAt ? m.generatedAt.slice(0, 16).replace('T', ' ') : '(none)';
+ // populate source filter dropdown from unique parents
+ const sources = [...new Set(items.map((i) => i.parent).filter(Boolean))].sort();
+ srcEl.innerHTML = '<option value="">(all)</option>' + sources.map((s) => `<option ${s === srcFilter ? 'selected' : ''} value="${escapeAttr(s)}">${escapeHtml(s)}</option>`).join('');
+ render();
+ }
+ loadManifest();
+ </script>
+</body>
+</html>
diff --git a/scan-mp3s.js b/scan-mp3s.js
new file mode 100644
index 0000000..8cd05aa
--- /dev/null
+++ b/scan-mp3s.js
@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+// scan-mp3s.js — walks SCAN_ROOTS and writes manifest.json with every .mp3 found.
+//
+// Output schema (per item):
+// {
+// id : 'a-z0-9 hash of full path (stable across runs)',
+// path : absolute path on disk (used by server /audio route)',
+// name : basename without .mp3',
+// parent : last directory segment (used as "Source" tag)',
+// parent2 : second-to-last directory segment (more specific source for UI)',
+// size : bytes',
+// mtime : ms epoch',
+// mtimeISO : ISO string',
+// duration : seconds (probed via ffprobe if available, else null)'
+// }
+//
+// Reads / writes nothing outside SCAN_ROOTS + project dir.
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync, spawnSync } = require('child_process');
+const crypto = require('crypto');
+
+const HOME = process.env.HOME || '/Users/stevestudio2';
+const SCAN_ROOTS = (process.env.SCAN_ROOTS || [
+ path.join(HOME, 'Projects'),
+ path.join(HOME, 'Videos'),
+ path.join(HOME, 'Desktop'),
+ path.join(HOME, '.claude/skills'),
+].join(',')).split(',').map((s) => s.trim()).filter(Boolean);
+
+// Exclude any path containing one of these substrings (case-insensitive).
+const EXCLUDE_SUBSTRINGS = [
+ '/node_modules/', '/.git/', '/.Trash/', '/Library/Caches/', '/kamatera-mirror/',
+ '/.cache/', '/.next/', '/dist/', '/build/',
+];
+
+const OUT_FILE = path.join(__dirname, 'manifest.json');
+const PROBE_DURATIONS = process.env.PROBE_DURATIONS !== '0';
+
+function hasFfprobe() {
+ try { execFileSync('which', ['ffprobe'], { stdio: 'ignore' }); return true; }
+ catch { return false; }
+}
+const FFPROBE_AVAILABLE = PROBE_DURATIONS && hasFfprobe();
+
+function ffprobeDuration(file) {
+ if (!FFPROBE_AVAILABLE) return null;
+ try {
+ const r = spawnSync('ffprobe', [
+ '-v', 'error',
+ '-show_entries', 'format=duration',
+ '-of', 'default=noprint_wrappers=1:nokey=1',
+ file,
+ ], { encoding: 'utf8', timeout: 5000 });
+ if (r.status !== 0) return null;
+ const sec = parseFloat(String(r.stdout).trim());
+ return Number.isFinite(sec) ? +sec.toFixed(2) : null;
+ } catch { return null; }
+}
+
+function shouldSkipDir(p) {
+ return EXCLUDE_SUBSTRINGS.some((s) => p.includes(s));
+}
+
+function* walk(root) {
+ const stack = [root];
+ while (stack.length) {
+ const dir = stack.pop();
+ if (shouldSkipDir(dir + '/')) continue;
+ let entries;
+ try { entries = fs.readdirSync(dir, { withFileTypes: true }); }
+ catch { continue; }
+ for (const e of entries) {
+ const full = path.join(dir, e.name);
+ if (e.isSymbolicLink()) continue;
+ if (e.isDirectory()) {
+ if (e.name.startsWith('.') && !['..', '.claude'].includes(e.name)) continue; // skip dotdirs except .claude itself
+ stack.push(full);
+ } else if (e.isFile() && e.name.toLowerCase().endsWith('.mp3')) {
+ yield full;
+ }
+ }
+ }
+}
+
+function id(p) {
+ return crypto.createHash('sha1').update(p).digest('hex').slice(0, 12);
+}
+
+const items = [];
+let scanned = 0;
+const t0 = Date.now();
+for (const root of SCAN_ROOTS) {
+ if (!fs.existsSync(root)) {
+ console.error(`(skip) root missing: ${root}`);
+ continue;
+ }
+ console.error(`scanning ${root} ...`);
+ for (const file of walk(root)) {
+ scanned++;
+ let stat;
+ try { stat = fs.statSync(file); } catch { continue; }
+ const parts = file.split(path.sep);
+ const parent = parts[parts.length - 2] || '';
+ const parent2 = parts[parts.length - 3] || '';
+ const name = path.basename(file, '.mp3');
+ const duration = ffprobeDuration(file);
+ items.push({
+ id: id(file),
+ path: file,
+ name,
+ parent,
+ parent2,
+ size: stat.size,
+ mtime: stat.mtimeMs,
+ mtimeISO: new Date(stat.mtimeMs).toISOString(),
+ duration,
+ });
+ if (scanned % 25 === 0) process.stderr.write(` scanned ${scanned} ...\n`);
+ }
+}
+
+// Newest first by default in the manifest.
+items.sort((a, b) => b.mtime - a.mtime);
+
+fs.writeFileSync(OUT_FILE, JSON.stringify({
+ generatedAt: new Date().toISOString(),
+ ffprobe: FFPROBE_AVAILABLE,
+ count: items.length,
+ totalSizeBytes: items.reduce((a, b) => a + b.size, 0),
+ items,
+}, null, 2));
+
+const ms = Date.now() - t0;
+console.error(`\n wrote ${items.length} mp3 entries → ${OUT_FILE} (${ms}ms, ffprobe=${FFPROBE_AVAILABLE})`);
diff --git a/server.js b/server.js
new file mode 100644
index 0000000..75c8a4d
--- /dev/null
+++ b/server.js
@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+// server.js — Express app for mp3.agentabrams.com.
+//
+// /api/manifest → JSON of every indexed MP3
+// /api/refresh → POST: re-runs scan-mp3s.js synchronously
+// /audio?id=<id> → streams the MP3 by manifest id (no path leak)
+// / → static public/index.html (grid + list + sliders + sort)
+
+const express = require('express');
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const PORT = parseInt(process.env.MP3_PORT || '9696', 10);
+const MANIFEST_FILE = path.join(__dirname, 'manifest.json');
+
+function loadManifest() {
+ if (!fs.existsSync(MANIFEST_FILE)) return { count: 0, items: [], generatedAt: null, error: 'no manifest — run `npm run scan`' };
+ try { return JSON.parse(fs.readFileSync(MANIFEST_FILE, 'utf8')); }
+ catch (e) { return { count: 0, items: [], error: 'manifest parse error: ' + e.message }; }
+}
+
+let manifest = loadManifest();
+let byId = new Map(manifest.items.map((i) => [i.id, i]));
+
+const app = express();
+app.use(express.static(path.join(__dirname, 'public'), { extensions: ['html'] }));
+
+app.get('/api/manifest', (_req, res) => {
+ res.json(manifest);
+});
+
+app.post('/api/refresh', express.json(), (_req, res) => {
+ const r = spawnSync('node', [path.join(__dirname, 'scan-mp3s.js')], { encoding: 'utf8', timeout: 120_000 });
+ manifest = loadManifest();
+ byId = new Map(manifest.items.map((i) => [i.id, i]));
+ res.json({ ok: r.status === 0, count: manifest.count, generatedAt: manifest.generatedAt, stderr: r.stderr ? r.stderr.slice(-500) : null });
+});
+
+// Stream MP3 by id only — paths never appear in URLs.
+app.get('/audio', (req, res) => {
+ const id = String(req.query.id || '');
+ const item = byId.get(id);
+ if (!item) return res.status(404).send('not found');
+ if (!fs.existsSync(item.path)) return res.status(410).send('file moved');
+ res.setHeader('Content-Type', 'audio/mpeg');
+ res.setHeader('Content-Disposition', `inline; filename="${encodeURIComponent(item.name)}.mp3"`);
+ res.setHeader('Accept-Ranges', 'bytes');
+ // Range support so the browser can seek.
+ const stat = fs.statSync(item.path);
+ const range = req.headers.range;
+ if (range) {
+ const m = /bytes=(\d+)-(\d*)/.exec(range);
+ if (m) {
+ const start = parseInt(m[1], 10);
+ const end = m[2] ? parseInt(m[2], 10) : stat.size - 1;
+ res.status(206);
+ res.setHeader('Content-Range', `bytes ${start}-${end}/${stat.size}`);
+ res.setHeader('Content-Length', end - start + 1);
+ fs.createReadStream(item.path, { start, end }).pipe(res);
+ return;
+ }
+ }
+ res.setHeader('Content-Length', stat.size);
+ fs.createReadStream(item.path).pipe(res);
+});
+
+app.get('/healthz', (_req, res) => {
+ res.status(manifest.count > 0 ? 200 : 503).json({
+ ok: manifest.count > 0,
+ count: manifest.count,
+ generatedAt: manifest.generatedAt,
+ });
+});
+
+app.listen(PORT, () => {
+ console.log(`\n mp3-agentabrams :: http://127.0.0.1:${PORT}`);
+ console.log(` serving ${manifest.count} mp3 entries`);
+ console.log(` manifest generated ${manifest.generatedAt}\n`);
+});
(oldest)
·
back to Mp3 Agentabrams
·
server: lock to loopback (127.0.0.1) — was silently bound to adfdb26 →