nixamp 0.41.2 → 0.43.0

package/dist/station-cli.js

@@ -265,6 +265,8 @@ export async function station(argv) {
                 return await aiCommand(argv.slice(1), call, show, json);
             case "shares":
                 return await sharesCommand(argv.slice(1), call, show);
+            case "lyrics":
+                return await lyricsCommand(argv.slice(1), call, show, json);
             case "holder":
             case "holders": {
                 const sub = argv[1] ?? "list";
@@ -417,6 +419,46 @@ async function aiCommand(argv, call, show, json) {
             return 2;
     }
 }
+/** `nixamp station lyrics ...`: our own songs' words, published back to nichedb.dev. */
+async function lyricsCommand(argv, call, show, json) {
+    const [sub, id] = argv;
+    switch (sub) {
+        case undefined:
+        case "status":
+            return show(await call("GET", "/api/v1/stations/lyrics"), (body) => {
+                const stations = body["stations"] ?? [];
+                const last = body["last"];
+                return [
+                    `key        ${body["key"] ? "set" : "- (nixamp station lyrics key, the value on stdin)"}`,
+                    `target     ${String(body["target"])}`,
+                    `published  ${String(body["published"])} files${body["running"] ? "; publishing now" : ""}`,
+                    ...(last ? [`last run   ${new Date(last.at).toISOString()}: ${last.reports.map((one) => `${String(one["station"])} +${String(one["published"])}`).join(", ") || "nothing eligible"}`] : []),
+                    ...(body["lastError"] ? [`problem    ${String(body["lastError"])}`] : []),
+                    "",
+                    ...stations.map((one) => `  ${String(one["id"])}  ${one["eligible"] ? "publishes" : "no       "} ${String(one["published"]).padStart(4)}/${String(one["files"]).padEnd(5)} ${String(one["name"])}${one["eligible"] ? "" : `  (${String(one["why"])})`}`),
+                ].join("\n");
+            });
+        case "publish": {
+            if (!id || id.startsWith("--")) {
+                console.error("nixamp station lyrics publish needs a station id");
+                return 2;
+            }
+            if (!json)
+                console.log("Publishing; a second between songs…");
+            return show(await call("POST", `/api/v1/stations/lyrics/${id}/publish`, {}), (body) => {
+                const report = body["report"];
+                return `${String(report["published"])} published, ${String(report["unchanged"])} already there, ${String(report["without"])} without words, ${String(report["failed"])} failed${report["stopped"] ? `\nstopped: ${String(report["stopped"])}` : ""}`;
+            });
+        }
+        case "key": {
+            const value = argv.includes("--clear") ? "" : await readStdin();
+            return show(await call("POST", "/api/v1/stations/ai/keys", { name: "NIXAMP_LYRICS_KEY", value }), (answer) => `nichedb lyrics key ${(answer["keys"] ?? {})["NIXAMP_LYRICS_KEY"] ? "set" : "cleared"}.`);
+        }
+        default:
+            console.error(`nixamp station lyrics: no command "${sub}".\n\n${USAGE}`);
+            return 2;
+    }
+}
 /** `nixamp station shares ...` */
 async function sharesCommand(argv, call, show) {
     const [sub, id] = argv;

package/dist/station-page.d.ts

@@ -1,6 +1,6 @@
 /** A station page's path: /station/<id>. */
 export declare const STATION_PAGE: RegExp;
-export declare const STATION_PAGE_HTML = "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<meta name=\"robots\" content=\"noindex\">\n<link rel=\"icon\" href=\"data:,\">\n<title>Station \u00B7 nixamp</title>\n<style>\n:root{--bg:#f6f5f2;--fg:#17171a;--muted:#5d5d66;--card:#fff;--line:#dedcd6;--accent:#1f6feb;--live:#0b7a3b;--warn:#9a6700;--off:#8c2f39}\n@media (prefers-color-scheme:dark){:root{--bg:#121214;--fg:#ececf1;--muted:#a4a4b0;--card:#1c1c20;--line:#2c2c33;--accent:#6aa7ff;--live:#3fbf7f;--warn:#e3b341;--off:#f0838f}}\n*{box-sizing:border-box}html,body{margin:0;background:var(--bg);color:var(--fg);font:16px/1.5 system-ui,-apple-system,\"Segoe UI\",sans-serif}\nmain{max-width:560px;margin:0 auto;padding:48px 16px}\n.card{background:var(--card);border:1px solid var(--line);border-radius:16px;padding:24px}\nh1{font-size:1.6rem;line-height:1.2;margin:0 0 4px}\n.about{color:var(--muted);margin:0 0 20px}\n.chip{display:inline-flex;align-items:center;gap:8px;font-size:.85rem;font-weight:600;padding:4px 10px;border-radius:999px;border:1px solid var(--line)}\n.chip::before{content:\"\";width:8px;height:8px;border-radius:50%;background:currentColor}\n.live{color:var(--live)}.reconnecting{color:var(--warn)}.unavailable,.stopped{color:var(--off)}\n.now{margin:20px 0;min-height:3em}.now .title{font-weight:600}.now .by{color:var(--muted)}\n.controls{display:flex;align-items:center;gap:16px;flex-wrap:wrap}\nbutton{font:inherit;font-weight:600;border:0;border-radius:999px;padding:12px 28px;background:var(--accent);color:#fff;cursor:pointer;min-width:120px}\nbutton:disabled{opacity:.5;cursor:not-allowed}\nbutton:focus-visible,input:focus-visible,a:focus-visible{outline:3px solid var(--accent);outline-offset:3px}\nlabel{display:flex;align-items:center;gap:8px;color:var(--muted);font-size:.9rem}\ninput[type=range]{width:120px;accent-color:var(--accent)}\n.small{margin-top:20px;font-size:.85rem;color:var(--muted)}.small a{color:inherit}\n.screen{display:block;width:100%;aspect-ratio:16/9;background:#000;border-radius:10px;margin:12px 0}\n.sr{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}\n@media (prefers-reduced-motion:no-preference){.live::before{animation:pulse 2s ease-in-out infinite}}\n@keyframes pulse{50%{opacity:.35}}\n</style>\n</head>\n<body>\n<main>\n  <div class=\"card\">\n    <span id=\"state\" class=\"chip unavailable\" role=\"status\">Loading</span>\n    <video id=\"screen\" class=\"screen\" playsinline preload=\"none\" hidden></video>\n    <h1 id=\"name\">&nbsp;</h1>\n    <p id=\"about\" class=\"about\" hidden></p>\n    <div class=\"now\" aria-live=\"polite\"><div id=\"title\" class=\"title\"></div><div id=\"by\" class=\"by\"></div></div>\n    <div class=\"controls\">\n      <button id=\"play\" type=\"button\" aria-pressed=\"false\" disabled>Play</button>\n      <label>Volume <input id=\"volume\" type=\"range\" min=\"0\" max=\"1\" step=\"0.05\" value=\"1\"></label>\n    </div>\n    <p class=\"small\"><a id=\"m3u\" href=\"#\">Open in another player (.m3u)</a> \u00B7 Pausing here does not pause the station.</p>\n  </div>\n  <p class=\"small\">Played by <a href=\"https://nixamp.com\">nixamp</a>.</p>\n  <div id=\"announce\" class=\"sr\" aria-live=\"assertive\"></div>\n</main>\n<script>\n(() => {\n  const id = location.pathname.split(\"/\").filter(Boolean)[1] || \"\";\n  const token = new URLSearchParams(location.search).get(\"t\") || \"\";\n  const q = \"?t=\" + encodeURIComponent(token);\n  const api = \"/api/v1/stations/\" + encodeURIComponent(id);\n  const $ = (s) => document.querySelector(s);\n  // Sound, or a TV station's picture: the element is chosen by the first state.\n  let audio = new Audio();\n  audio.preload = \"none\";\n  let wired = false;\n  const wire = () => {\n    if (wired) return;\n    wired = true;\n    audio.addEventListener(\"playing\", () => { if (retry) say(\"Back on\"); retry = 0; if (last) draw(last); });\n    audio.addEventListener(\"error\", again);\n    audio.addEventListener(\"ended\", again);\n    audio.addEventListener(\"stalled\", () => { if (wanted && audio.readyState < 3) again(); });\n  };\n  let wanted = false, retry = 0, timer = 0, last = null, live = false;\n  const chip = (state, text) => { const c = $(\"#state\"); c.className = \"chip \" + state; c.textContent = text; };\n  const say = (text) => { $(\"#announce\").textContent = text; };\n  const draw = (s) => {\n    last = s;\n    if (s.kind === \"video\" && audio.tagName !== \"VIDEO\") {\n      audio = $(\"#screen\");\n      audio.hidden = false;\n      wired = false;\n      wire();\n    }\n    document.title = s.name + \" \u00B7 nixamp\";\n    $(\"#name\").textContent = s.name;\n    $(\"#about\").textContent = s.description || \"\";\n    $(\"#about\").hidden = !s.description;\n    if (!live) title(s);\n    if (wanted && retry > 0) chip(\"reconnecting\", \"Reconnecting\");\n    else if (s.state === \"live\") chip(\"live\", \"Live\");\n    else if (s.state === \"starting\" || s.state === \"recovering\") chip(\"reconnecting\", \"Coming back\");\n    else if (s.state === \"stopped\") chip(\"stopped\", \"Off the air\");\n    else chip(\"unavailable\", \"Unavailable\");\n    $(\"#play\").disabled = !(s.state === \"live\" || s.state === \"recovering\" || s.state === \"starting\");\n    $(\"#m3u\").href = api + \"/listen.m3u\" + q;\n  };\n  const title = (s) => {\n    const playing = s.nowPlaying;\n    $(\"#title\").textContent = playing ? (playing.title || \"Untitled\") : (s.state === \"live\" ? \"On the air\" : \"\");\n    $(\"#by\").textContent = playing ? [playing.artist, playing.album].filter(Boolean).join(\" \u00B7 \") : \"\";\n  };\n  // What is ahead of the speaker: the sound the player holds and has not\n  // played yet. A new title waits that long, so it changes with the song.\n  const ahead = () => {\n    if (!wanted || audio.paused || audio.buffered.length === 0) return 0;\n    return Math.max(0, Math.min(30, audio.buffered.end(audio.buffered.length - 1) - audio.currentTime));\n  };\n  const listen = () => {\n    if (!window.EventSource) return;\n    const events = new EventSource(api + \"/events\" + q);\n    events.addEventListener(\"hello\", (e) => { live = true; title(JSON.parse(e.data)); });\n    events.addEventListener(\"now\", (e) => {\n      const s = JSON.parse(e.data);\n      setTimeout(() => { title(s); say(s.nowPlaying ? \"Now playing \" + (s.nowPlaying.title || \"\") : \"\"); }, ahead() * 1000);\n    });\n    events.addEventListener(\"state\", () => poll());\n    events.onerror = () => { live = false; };\n  };\n  const poll = async () => {\n    try {\n      const r = await fetch(api + \"/state\" + q, { cache: \"no-store\" });\n      if (r.status === 404) { $(\"#name\").textContent = \"This station is not available\"; chip(\"unavailable\", \"Unavailable\"); $(\"#play\").disabled = true; stop(); return; }\n      if (r.ok) draw(await r.json());\n    } catch {}\n  };\n  // Always the live edge: a fresh request, never a cached or paused one.\n  const join = () => { audio.src = api + \"/stream\" + q + \"&n=\" + Date.now(); audio.play().catch(() => { wanted = false; button(); }); };\n  const stop = () => { wanted = false; clearTimeout(timer); audio.pause(); audio.removeAttribute(\"src\"); audio.load(); button(); };\n  const button = () => { const b = $(\"#play\"); b.textContent = wanted ? \"Stop\" : \"Play\"; b.setAttribute(\"aria-pressed\", String(wanted)); };\n  const again = () => {\n    if (!wanted) return;\n    retry += 1;\n    if (last) draw(last);\n    clearTimeout(timer);\n    timer = setTimeout(join, Math.min(15000, 1000 * 2 ** Math.min(retry, 4)));\n  };\n  wire();\n  $(\"#play\").addEventListener(\"click\", () => { if (wanted) { stop(); say(\"Stopped\"); } else { wanted = true; retry = 0; button(); join(); say(\"Playing\"); } });\n  $(\"#volume\").addEventListener(\"input\", (e) => { audio.volume = Number(e.target.value); });\n  poll();\n  listen();\n  setInterval(poll, 5000);\n})();\n</script>\n</body>\n</html>\n";
+export declare const STATION_PAGE_HTML = "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<meta name=\"robots\" content=\"noindex\">\n<link rel=\"icon\" href=\"data:,\">\n<title>Station \u00B7 nixamp</title>\n<style>\n:root{--bg:#f6f5f2;--fg:#17171a;--muted:#5d5d66;--card:#fff;--line:#dedcd6;--accent:#1f6feb;--live:#0b7a3b;--warn:#9a6700;--off:#8c2f39}\n@media (prefers-color-scheme:dark){:root{--bg:#121214;--fg:#ececf1;--muted:#a4a4b0;--card:#1c1c20;--line:#2c2c33;--accent:#6aa7ff;--live:#3fbf7f;--warn:#e3b341;--off:#f0838f}}\n*{box-sizing:border-box}[hidden]{display:none!important}html,body{margin:0;background:var(--bg);color:var(--fg);font:16px/1.5 system-ui,-apple-system,\"Segoe UI\",sans-serif}\nmain{max-width:560px;margin:0 auto;padding:48px 16px}\n.card{background:var(--card);border:1px solid var(--line);border-radius:16px;padding:24px}\nh1{font-size:1.6rem;line-height:1.2;margin:0 0 4px}\n.about{color:var(--muted);margin:0 0 20px}\n.chip{display:inline-flex;align-items:center;gap:8px;font-size:.85rem;font-weight:600;padding:4px 10px;border-radius:999px;border:1px solid var(--line)}\n.chip::before{content:\"\";width:8px;height:8px;border-radius:50%;background:currentColor}\n.live{color:var(--live)}.reconnecting{color:var(--warn)}.unavailable,.stopped{color:var(--off)}\n.now{margin:20px 0;min-height:3em}.now .title{font-weight:600}.now .by{color:var(--muted)}\n.controls{display:flex;align-items:center;gap:16px;flex-wrap:wrap}\nbutton{font:inherit;font-weight:600;border:0;border-radius:999px;padding:12px 28px;background:var(--accent);color:#fff;cursor:pointer;min-width:120px}\nbutton:disabled{opacity:.5;cursor:not-allowed}\nbutton:focus-visible,input:focus-visible,a:focus-visible{outline:3px solid var(--accent);outline-offset:3px}\nlabel{display:flex;align-items:center;gap:8px;color:var(--muted);font-size:.9rem}\ninput[type=range]{width:120px;accent-color:var(--accent)}\n.small{margin-top:20px;font-size:.85rem;color:var(--muted)}.small a{color:inherit}\n.lyrics{margin:20px 0 0;border-top:1px solid var(--line);padding-top:12px}\n.lyrics summary{cursor:pointer;font-weight:600;min-height:24px}\n.lyrics .for{font-weight:400;color:var(--muted);font-size:.9rem}\n.words{margin-top:10px;line-height:1.6}\n.words p{margin:0 0 1em;white-space:pre-wrap;overflow-wrap:anywhere}\n.words p.sec{margin:1.2em 0 .3em;font-size:.75rem;letter-spacing:.06em;text-transform:uppercase;color:var(--muted)}\n.words p.sec:first-child{margin-top:0}\n.screen{display:block;width:100%;aspect-ratio:16/9;background:#000;border-radius:10px;margin:12px 0}\n.sr{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}\n@media (prefers-reduced-motion:no-preference){.live::before{animation:pulse 2s ease-in-out infinite}}\n@keyframes pulse{50%{opacity:.35}}\n</style>\n</head>\n<body>\n<main>\n  <div class=\"card\">\n    <span id=\"state\" class=\"chip unavailable\" role=\"status\">Loading</span>\n    <video id=\"screen\" class=\"screen\" playsinline preload=\"none\" hidden></video>\n    <h1 id=\"name\">&nbsp;</h1>\n    <p id=\"about\" class=\"about\" hidden></p>\n    <div class=\"now\" aria-live=\"polite\"><div id=\"title\" class=\"title\"></div><div id=\"by\" class=\"by\"></div></div>\n    <div class=\"controls\">\n      <button id=\"play\" type=\"button\" aria-pressed=\"false\" disabled>Play</button>\n      <label>Volume <input id=\"volume\" type=\"range\" min=\"0\" max=\"1\" step=\"0.05\" value=\"1\"></label>\n    </div>\n    <section id=\"lyrics\" class=\"lyrics\" aria-label=\"Lyrics\" hidden>\n      <details id=\"lyrics-box\" open><summary>Lyrics<span id=\"lyrics-for\" class=\"for\"></span></summary><div id=\"words\" class=\"words\"></div></details>\n    </section>\n    <p class=\"small\"><a id=\"m3u\" href=\"#\">Open in another player (.m3u)</a> \u00B7 Pausing here does not pause the station.</p>\n  </div>\n  <p class=\"small\">Played by <a href=\"https://nixamp.com\">nixamp</a>.</p>\n  <div id=\"announce\" class=\"sr\" aria-live=\"assertive\"></div>\n</main>\n<script>\n(() => {\n  const id = location.pathname.split(\"/\").filter(Boolean)[1] || \"\";\n  const token = new URLSearchParams(location.search).get(\"t\") || \"\";\n  const q = \"?t=\" + encodeURIComponent(token);\n  const api = \"/api/v1/stations/\" + encodeURIComponent(id);\n  const $ = (s) => document.querySelector(s);\n  // Sound, or a TV station's picture: the element is chosen by the first state.\n  let audio = new Audio();\n  audio.preload = \"none\";\n  let wired = false;\n  const wire = () => {\n    if (wired) return;\n    wired = true;\n    audio.addEventListener(\"playing\", () => { if (retry) say(\"Back on\"); retry = 0; if (last) draw(last); });\n    audio.addEventListener(\"error\", again);\n    audio.addEventListener(\"ended\", again);\n    audio.addEventListener(\"stalled\", () => { if (wanted && audio.readyState < 3) again(); });\n  };\n  let wanted = false, retry = 0, timer = 0, last = null, live = false;\n  const chip = (state, text) => { const c = $(\"#state\"); c.className = \"chip \" + state; c.textContent = text; };\n  const say = (text) => { $(\"#announce\").textContent = text; };\n  const draw = (s) => {\n    last = s;\n    if (s.kind === \"video\" && audio.tagName !== \"VIDEO\") {\n      audio = $(\"#screen\");\n      audio.hidden = false;\n      wired = false;\n      wire();\n    }\n    document.title = s.name + \" \u00B7 nixamp\";\n    $(\"#name\").textContent = s.name;\n    $(\"#about\").textContent = s.description || \"\";\n    $(\"#about\").hidden = !s.description;\n    if (!live) title(s);\n    if (wanted && retry > 0) chip(\"reconnecting\", \"Reconnecting\");\n    else if (s.state === \"live\") chip(\"live\", \"Live\");\n    else if (s.state === \"starting\" || s.state === \"recovering\") chip(\"reconnecting\", \"Coming back\");\n    else if (s.state === \"stopped\") chip(\"stopped\", \"Off the air\");\n    else chip(\"unavailable\", \"Unavailable\");\n    $(\"#play\").disabled = !(s.state === \"live\" || s.state === \"recovering\" || s.state === \"starting\");\n    $(\"#m3u\").href = api + \"/listen.m3u\" + q;\n  };\n  const title = (s) => {\n    const playing = s.nowPlaying;\n    $(\"#title\").textContent = playing ? (playing.title || \"Untitled\") : (s.state === \"live\" ? \"On the air\" : \"\");\n    $(\"#by\").textContent = playing ? [playing.artist, playing.album].filter(Boolean).join(\" \u00B7 \") : \"\";\n  };\n  // What is ahead of the speaker: the sound the player holds and has not\n  // played yet. A new title waits that long, so it changes with the song.\n  const ahead = () => {\n    if (!wanted || audio.paused || audio.buffered.length === 0) return 0;\n    return Math.max(0, Math.min(30, audio.buffered.end(audio.buffered.length - 1) - audio.currentTime));\n  };\n  // The words of what is on, line by line; \"[Verse 1]\" as a small header. Text only, never HTML.\n  let words = null;\n  const lyrics = async () => {\n    try {\n      const r = await fetch(api + \"/lyrics\" + q, { cache: \"no-store\" });\n      const got = r.ok ? (await r.json()).lyrics : null;\n      const key = got ? got.title + \"\\n\" + got.text : \"\";\n      if (key === words) return;\n      words = key;\n      $(\"#lyrics\").hidden = !got;\n      if (!got) return;\n      const out = [];\n      let stanza = [];\n      const flush = () => { if (stanza.length) { const p = document.createElement(\"p\"); p.textContent = stanza.join(\"\\n\"); out.push(p); stanza = []; } };\n      for (const line of got.text.split(\"\\n\")) {\n        if (/^\\s*\\[[^\\]]{1,160}\\]\\s*$/.test(line)) { flush(); const h = document.createElement(\"p\"); h.className = \"sec\"; h.textContent = line.trim().slice(1, -1); out.push(h); }\n        else if (line.trim() === \"\") flush();\n        else stanza.push(line);\n      }\n      flush();\n      $(\"#words\").replaceChildren(...out);\n      $(\"#lyrics-for\").textContent = got.title ? \" \u00B7 \" + got.title : \"\";\n    } catch {}\n  };\n  const listen = () => {\n    if (!window.EventSource) return;\n    const events = new EventSource(api + \"/events\" + q);\n    events.addEventListener(\"hello\", (e) => { live = true; title(JSON.parse(e.data)); lyrics(); });\n    events.addEventListener(\"now\", (e) => {\n      const s = JSON.parse(e.data);\n      setTimeout(() => { title(s); lyrics(); say(s.nowPlaying ? \"Now playing \" + (s.nowPlaying.title || \"\") : \"\"); }, ahead() * 1000);\n    });\n    events.addEventListener(\"state\", () => poll());\n    events.onerror = () => { live = false; };\n  };\n  const poll = async () => {\n    try {\n      const r = await fetch(api + \"/state\" + q, { cache: \"no-store\" });\n      if (r.status === 404) { $(\"#name\").textContent = \"This station is not available\"; chip(\"unavailable\", \"Unavailable\"); $(\"#play\").disabled = true; stop(); return; }\n      if (r.ok) draw(await r.json());\n    } catch {}\n  };\n  // Always the live edge: a fresh request, never a cached or paused one.\n  const join = () => { audio.src = api + \"/stream\" + q + \"&n=\" + Date.now(); audio.play().catch(() => { wanted = false; button(); }); };\n  const stop = () => { wanted = false; clearTimeout(timer); audio.pause(); audio.removeAttribute(\"src\"); audio.load(); button(); };\n  const button = () => { const b = $(\"#play\"); b.textContent = wanted ? \"Stop\" : \"Play\"; b.setAttribute(\"aria-pressed\", String(wanted)); };\n  const again = () => {\n    if (!wanted) return;\n    retry += 1;\n    if (last) draw(last);\n    clearTimeout(timer);\n    timer = setTimeout(join, Math.min(15000, 1000 * 2 ** Math.min(retry, 4)));\n  };\n  wire();\n  $(\"#play\").addEventListener(\"click\", () => { if (wanted) { stop(); say(\"Stopped\"); } else { wanted = true; retry = 0; button(); join(); say(\"Playing\"); } });\n  $(\"#volume\").addEventListener(\"input\", (e) => { audio.volume = Number(e.target.value); });\n  if (window.matchMedia && matchMedia(\"(max-width: 640px)\").matches) $(\"#lyrics-box\").open = false;\n  poll();\n  lyrics();\n  listen();\n  setInterval(poll, 5000);\n})();\n</script>\n</body>\n</html>\n";
 /** Only its own script and style, only its own server, never framed. */
 export declare const STATION_PAGE_CSP: string;
 /** The built page: its own bundle, styles and player engines, only this server, never framed. */

package/dist/station-page.js

@@ -13,7 +13,7 @@ import { createHash } from "node:crypto";
 const STYLE = `
 :root{--bg:#f6f5f2;--fg:#17171a;--muted:#5d5d66;--card:#fff;--line:#dedcd6;--accent:#1f6feb;--live:#0b7a3b;--warn:#9a6700;--off:#8c2f39}
 @media (prefers-color-scheme:dark){:root{--bg:#121214;--fg:#ececf1;--muted:#a4a4b0;--card:#1c1c20;--line:#2c2c33;--accent:#6aa7ff;--live:#3fbf7f;--warn:#e3b341;--off:#f0838f}}
-*{box-sizing:border-box}html,body{margin:0;background:var(--bg);color:var(--fg);font:16px/1.5 system-ui,-apple-system,"Segoe UI",sans-serif}
+*{box-sizing:border-box}[hidden]{display:none!important}html,body{margin:0;background:var(--bg);color:var(--fg);font:16px/1.5 system-ui,-apple-system,"Segoe UI",sans-serif}
 main{max-width:560px;margin:0 auto;padding:48px 16px}
 .card{background:var(--card);border:1px solid var(--line);border-radius:16px;padding:24px}
 h1{font-size:1.6rem;line-height:1.2;margin:0 0 4px}
@@ -29,6 +29,13 @@ button:focus-visible,input:focus-visible,a:focus-visible{outline:3px solid var(-
 label{display:flex;align-items:center;gap:8px;color:var(--muted);font-size:.9rem}
 input[type=range]{width:120px;accent-color:var(--accent)}
 .small{margin-top:20px;font-size:.85rem;color:var(--muted)}.small a{color:inherit}
+.lyrics{margin:20px 0 0;border-top:1px solid var(--line);padding-top:12px}
+.lyrics summary{cursor:pointer;font-weight:600;min-height:24px}
+.lyrics .for{font-weight:400;color:var(--muted);font-size:.9rem}
+.words{margin-top:10px;line-height:1.6}
+.words p{margin:0 0 1em;white-space:pre-wrap;overflow-wrap:anywhere}
+.words p.sec{margin:1.2em 0 .3em;font-size:.75rem;letter-spacing:.06em;text-transform:uppercase;color:var(--muted)}
+.words p.sec:first-child{margin-top:0}
 .screen{display:block;width:100%;aspect-ratio:16/9;background:#000;border-radius:10px;margin:12px 0}
 .sr{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
 @media (prefers-reduced-motion:no-preference){.live::before{animation:pulse 2s ease-in-out infinite}}
@@ -88,13 +95,37 @@ const SCRIPT = `
     if (!wanted || audio.paused || audio.buffered.length === 0) return 0;
     return Math.max(0, Math.min(30, audio.buffered.end(audio.buffered.length - 1) - audio.currentTime));
   };
+  // The words of what is on, line by line; "[Verse 1]" as a small header. Text only, never HTML.
+  let words = null;
+  const lyrics = async () => {
+    try {
+      const r = await fetch(api + "/lyrics" + q, { cache: "no-store" });
+      const got = r.ok ? (await r.json()).lyrics : null;
+      const key = got ? got.title + "\\n" + got.text : "";
+      if (key === words) return;
+      words = key;
+      $("#lyrics").hidden = !got;
+      if (!got) return;
+      const out = [];
+      let stanza = [];
+      const flush = () => { if (stanza.length) { const p = document.createElement("p"); p.textContent = stanza.join("\\n"); out.push(p); stanza = []; } };
+      for (const line of got.text.split("\\n")) {
+        if (/^\\s*\\[[^\\]]{1,160}\\]\\s*$/.test(line)) { flush(); const h = document.createElement("p"); h.className = "sec"; h.textContent = line.trim().slice(1, -1); out.push(h); }
+        else if (line.trim() === "") flush();
+        else stanza.push(line);
+      }
+      flush();
+      $("#words").replaceChildren(...out);
+      $("#lyrics-for").textContent = got.title ? " · " + got.title : "";
+    } catch {}
+  };
   const listen = () => {
     if (!window.EventSource) return;
     const events = new EventSource(api + "/events" + q);
-    events.addEventListener("hello", (e) => { live = true; title(JSON.parse(e.data)); });
+    events.addEventListener("hello", (e) => { live = true; title(JSON.parse(e.data)); lyrics(); });
     events.addEventListener("now", (e) => {
       const s = JSON.parse(e.data);
-      setTimeout(() => { title(s); say(s.nowPlaying ? "Now playing " + (s.nowPlaying.title || "") : ""); }, ahead() * 1000);
+      setTimeout(() => { title(s); lyrics(); say(s.nowPlaying ? "Now playing " + (s.nowPlaying.title || "") : ""); }, ahead() * 1000);
     });
     events.addEventListener("state", () => poll());
     events.onerror = () => { live = false; };
@@ -120,7 +151,9 @@ const SCRIPT = `
   wire();
   $("#play").addEventListener("click", () => { if (wanted) { stop(); say("Stopped"); } else { wanted = true; retry = 0; button(); join(); say("Playing"); } });
   $("#volume").addEventListener("input", (e) => { audio.volume = Number(e.target.value); });
+  if (window.matchMedia && matchMedia("(max-width: 640px)").matches) $("#lyrics-box").open = false;
   poll();
+  lyrics();
   listen();
   setInterval(poll, 5000);
 })();
@@ -148,6 +181,9 @@ const PAGE = `<!doctype html>
       <button id="play" type="button" aria-pressed="false" disabled>Play</button>
       <label>Volume <input id="volume" type="range" min="0" max="1" step="0.05" value="1"></label>
     </div>
+    <section id="lyrics" class="lyrics" aria-label="Lyrics" hidden>
+      <details id="lyrics-box" open><summary>Lyrics<span id="lyrics-for" class="for"></span></summary><div id="words" class="words"></div></details>
+    </section>
     <p class="small"><a id="m3u" href="#">Open in another player (.m3u)</a> · Pausing here does not pause the station.</p>
   </div>
   <p class="small">Played by <a href="https://nixamp.com">nixamp</a>.</p>

package/dist/station-routes.d.ts

@@ -17,6 +17,8 @@ import type { Channels } from "./channels.ts";
 import type { StationRunner } from "./station-runner.ts";
 import { type Limits, type StationUsage } from "./station-metering.ts";
 import { type TrackFacts } from "./track-facts.ts";
+import type { Lyrics } from "./lyrics.ts";
+import type { PublishReport } from "./lyrics-publish.ts";
 import { type OwnerStation, type PublicStation, type Station, type StationStore } from "./stations.ts";
 /** Whether this path is one a station's own link may open, without the server's key. */
 export declare function isStationListenPath(path: string): boolean;
@@ -67,6 +69,13 @@ export interface StationContext {
         bytes: Buffer;
         type: string;
     } | null>;
+    /** The words of a file, from its tags or nichedb; null when none are known. */
+    lyrics?: (station: Station, file: string) => Promise<Lyrics | null>;
+    /** Our own songs' words, published back to nichedb (lyrics-publish.ts). */
+    lyricsPublisher?: {
+        status: () => unknown;
+        publish: (station: Station) => Promise<PublishReport>;
+    };
     /** Auto stations: run a sync with these settings (and keep them), or read them. */
     auto?: {
         sync: (input: Record<string, unknown>) => Promise<unknown>;

package/dist/station-routes.js

@@ -2,7 +2,7 @@ import { alertsFor } from "./station-metering.js";
 import { aiFromTags } from "./track-facts.js";
 import { StationError, channelOf, tokensMatch, } from "./stations.js";
 /** The three things a station's link opens. */
-const LISTEN = /^\/api\/v1\/stations\/([a-z0-9]{10})\/(stream|state|listen\.m3u|events|now|art)$/;
+const LISTEN = /^\/api\/v1\/stations\/([a-z0-9]{10})\/(stream|state|listen\.m3u|events|now|art|lyrics)$/;
 /** Whether this path is one a station's own link may open, without the server's key. */
 export function isStationListenPath(path) {
     return LISTEN.test(path) || path === "/api/v1/stations/guide";
@@ -199,6 +199,16 @@ export async function handleStations(request, response, path, url, ctx) {
             response.end(method === "HEAD" ? undefined : picture.bytes);
             return true;
         }
+        if (what === "lyrics") {
+            const file = ctx.runner.observed(station.id) === "live" || ctx.runner.observed(station.id) === "recovering" ? nowPlayingFile(ctx, station) : "";
+            const lyrics = file && ctx.lyrics ? await ctx.lyrics(station, file).catch(() => null) : null;
+            if (!lyrics) {
+                ctx.json(response, 404, { error: "no lyrics for what is playing", code: "not_found" });
+                return true;
+            }
+            ctx.json(response, 200, { lyrics: { title: lyrics.title, artist: lyrics.artist, text: lyrics.text, source: lyrics.source, language: lyrics.language } });
+            return true;
+        }
         if (what === "now") {
             const file = ctx.runner.observed(station.id) === "live" || ctx.runner.observed(station.id) === "recovering" ? nowPlayingFile(ctx, station) : "";
             ctx.json(response, 200, { station: station.id, facts: file && ctx.facts ? await ctx.facts(station, file).catch(() => null) : null });
@@ -347,6 +357,34 @@ export async function handleStations(request, response, path, url, ctx) {
             ctx.json(response, 405, { error: "GET or POST", code: "method_not_allowed" });
             return true;
         }
+        if (path === "/api/v1/stations/lyrics") {
+            if (!ctx.lyricsPublisher) {
+                ctx.json(response, 404, { error: "lyrics publishing is not available here", code: "not_found" });
+                return true;
+            }
+            if (method !== "GET") {
+                ctx.json(response, 405, { error: "GET", code: "method_not_allowed" });
+                return true;
+            }
+            ctx.json(response, 200, ctx.lyricsPublisher.status());
+            return true;
+        }
+        const publishLyrics = /^\/api\/v1\/stations\/lyrics\/([a-z0-9]{10})\/publish$/.exec(path);
+        if (publishLyrics) {
+            const target = ctx.store.get(publishLyrics[1]);
+            if (!ctx.lyricsPublisher || !target) {
+                ctx.json(response, 404, { error: "no such station", code: "not_found" });
+                return true;
+            }
+            if (method !== "POST") {
+                ctx.json(response, 405, { error: "POST", code: "method_not_allowed" });
+                return true;
+            }
+            const report = await ctx.lyricsPublisher.publish(target);
+            const refused = report.stopped.startsWith("not published") ? "not_eligible" : report.stopped.startsWith("no key") ? "no_key" : "";
+            ctx.json(response, refused ? 409 : 200, refused ? { error: report.stopped, code: refused, report } : { report });
+            return true;
+        }
         const match = /^\/api\/v1\/stations\/([a-z0-9]{10})(?:\/([a-z-]+))?$/.exec(path);
         if (!match) {
             ctx.json(response, 404, { error: "no such station", code: "not_found" });

package/dist/station-usage.d.ts

@@ -1,2 +1,2 @@
 /** `nixamp station` usage, apart so `nixamp help station` does not load the client. */
-export declare const USAGE = "nixamp station \u2014 make a collection into a station\n\n  nixamp station list\n  nixamp station create --name NAME (--folder PATH | --playlist ID | --items 0,1,2) [--shuffle] [--no-repeat] [--bitrate 128] [--breaks 600]\n  nixamp station show ID\n  nixamp station status ID\n  nixamp station start ID\n  nixamp station stop ID\n  nixamp station skip ID\n  nixamp station breaks ID SECONDS a spot between entries every SECONDS (120..86400; --off for none)\n  nixamp station retry ID          try every left-out file again\n  nixamp station publish ID --basis owned|permission|licensed|public-domain [--note TEXT] [--unlisted] [--no-list]\n  nixamp station unpublish ID [--private]\n  nixamp station link ID [--rotate]\n  nixamp station delete ID\n  nixamp station guide-host NAME [--remove]\n                     NAME's front page is the public station guide (e.g. a Moshpit name)\n  nixamp station guide-peer URL [--remove]\n                     the guide also lists the public, listed stations of the server at URL\n  nixamp station auto [--no-video] [--min 10] [--films 3] [--tv 2] [--breaks 600] [--no-start]\n                     a station per genre, kept in step with the library (--off stops it)\n\n  AI radio (music composed for a station, a few tracks a day):\n  nixamp station ai                          what is composing, this month's seconds, the stations\n  nixamp station ai create (--preset lofi|synthwave|ambient|chiptune|punk|jazz | --name NAME --style TEXT)\n                     [--vocals] [--seconds 120] [--per-day 2] [--unlisted]   public on the guide unless --unlisted\n  nixamp station ai generate KEY             compose one now\n  nixamp station ai set KEY [--style TEXT] [--per-day N] [--seconds N] [--off|--on]\n  nixamp station ai remove KEY [--files]\n  nixamp station ai budget SECONDS           seconds of music a month across AI stations (0: no cap)\n  nixamp station ai resume                   after the provider ran out of credit\n  nixamp station ai key NAME                 ELEVENLABS_API_KEY | GEMINI_API_KEY | OPENAI_API_KEY | ANTHROPIC_API_KEY,\n                                             NIXAMP_OPENAI_URL | NIXAMP_OPENAI_MODEL (an OpenAI-compatible stand-in), from stdin\n\n  Listener shares (anybody shares an MP3 link or file from the guide; AI files and checks it):\n  nixamp station shares                      the setting and what is waiting\n  nixamp station shares on [--owner-moderation] [--unlisted] [--max-mb 60] [--per-hour 6]\n  nixamp station shares off\n  nixamp station shares list [--state held|approved|reported|rejected]\n  nixamp station shares approve|reject|delete SHARE\n  nixamp station shares trust ADDRESS [--remove]   believe this proxy's X-Forwarded-For\n\n  Copyright holders (the now-playing card: who holds a track's copyright, and how to support them):\n  nixamp station holder list\n  nixamp station holder set NAME [--artist ARTIST]... [--station ID]... [--support https://...] [--label Subscribe] [--license TEXT]\n  nixamp station holder remove ID\n\n  --json        machine-readable output\n  --url, --key  another server, as with `nixamp admin`\n\nA new station is private and stopped. Starting it does not publish it.";
+export declare const USAGE = "nixamp station \u2014 make a collection into a station\n\n  nixamp station list\n  nixamp station create --name NAME (--folder PATH | --playlist ID | --items 0,1,2) [--shuffle] [--no-repeat] [--bitrate 128] [--breaks 600]\n  nixamp station show ID\n  nixamp station status ID\n  nixamp station start ID\n  nixamp station stop ID\n  nixamp station skip ID\n  nixamp station breaks ID SECONDS a spot between entries every SECONDS (120..86400; --off for none)\n  nixamp station retry ID          try every left-out file again\n  nixamp station publish ID --basis owned|permission|licensed|public-domain [--note TEXT] [--unlisted] [--no-list]\n  nixamp station unpublish ID [--private]\n  nixamp station link ID [--rotate]\n  nixamp station delete ID\n  nixamp station guide-host NAME [--remove]\n                     NAME's front page is the public station guide (e.g. a Moshpit name)\n  nixamp station guide-peer URL [--remove]\n                     the guide also lists the public, listed stations of the server at URL\n  nixamp station auto [--no-video] [--min 10] [--films 3] [--tv 2] [--breaks 600] [--no-start]\n                     a station per genre, kept in step with the library (--off stops it)\n\n  AI radio (music composed for a station, a few tracks a day):\n  nixamp station ai                          what is composing, this month's seconds, the stations\n  nixamp station ai create (--preset lofi|synthwave|ambient|chiptune|punk|jazz | --name NAME --style TEXT)\n                     [--vocals] [--seconds 120] [--per-day 2] [--unlisted]   public on the guide unless --unlisted\n  nixamp station ai generate KEY             compose one now\n  nixamp station ai set KEY [--style TEXT] [--per-day N] [--seconds N] [--off|--on]\n  nixamp station ai remove KEY [--files]\n  nixamp station ai budget SECONDS           seconds of music a month across AI stations (0: no cap)\n  nixamp station ai resume                   after the provider ran out of credit\n  nixamp station ai key NAME                 ELEVENLABS_API_KEY | GEMINI_API_KEY | OPENAI_API_KEY | ANTHROPIC_API_KEY,\n                                             NIXAMP_OPENAI_URL | NIXAMP_OPENAI_MODEL (an OpenAI-compatible stand-in), from stdin\n\n  Listener shares (anybody shares an MP3 link or file from the guide; AI files and checks it):\n  nixamp station shares                      the setting and what is waiting\n  nixamp station shares on [--owner-moderation] [--unlisted] [--max-mb 60] [--per-hour 6]\n  nixamp station shares off\n  nixamp station shares list [--state held|approved|reported|rejected]\n  nixamp station shares approve|reject|delete SHARE\n  nixamp station shares trust ADDRESS [--remove]   believe this proxy's X-Forwarded-For\n\n  Lyrics (shown on the station page from each file's own tag, else nichedb.dev; ours published back):\n  nixamp station lyrics                      the key, what was published, which stations may publish\n  nixamp station lyrics publish ID           publish a station's words now (public, listed, basis owned only)\n  nixamp station lyrics key                  nichedb's key (NIXAMP_LYRICS_KEY), from stdin (--clear forgets it)\n\n  Copyright holders (the now-playing card: who holds a track's copyright, and how to support them):\n  nixamp station holder list\n  nixamp station holder set NAME [--artist ARTIST]... [--station ID]... [--support https://...] [--label Subscribe] [--license TEXT]\n  nixamp station holder remove ID\n\n  --json        machine-readable output\n  --url, --key  another server, as with `nixamp admin`\n\nA new station is private and stopped. Starting it does not publish it.";

package/dist/station-usage.js

@@ -41,6 +41,11 @@ export const USAGE = `nixamp station — make a collection into a station
   nixamp station shares approve|reject|delete SHARE
   nixamp station shares trust ADDRESS [--remove]   believe this proxy's X-Forwarded-For
 
+  Lyrics (shown on the station page from each file's own tag, else nichedb.dev; ours published back):
+  nixamp station lyrics                      the key, what was published, which stations may publish
+  nixamp station lyrics publish ID           publish a station's words now (public, listed, basis owned only)
+  nixamp station lyrics key                  nichedb's key (NIXAMP_LYRICS_KEY), from stdin (--clear forgets it)
+
   Copyright holders (the now-playing card: who holds a track's copyright, and how to support them):
   nixamp station holder list
   nixamp station holder set NAME [--artist ARTIST]... [--station ID]... [--support https://...] [--label Subscribe] [--license TEXT]

package/dist/stations.d.ts

@@ -78,6 +78,8 @@ export declare class StationStore {
         write: (path: string, body: string) => void;
     });
     static fileFor(stateDir: string, port: number): string;
+    /** Told after every change is written (lyrics publishing listens). */
+    onSaved: (() => void) | null;
     private save;
     list(): Station[];
     get(id: string): Station | undefined;

package/dist/stations.js

@@ -136,8 +136,14 @@ export class StationStore {
     static fileFor(stateDir, port) {
         return join(stateDir, `stations-${port}.json`);
     }
+    /** Told after every change is written (lyrics publishing listens). */
+    onSaved = null;
     save() {
         this.io.write(this.file, `${JSON.stringify({ version: 1, stations: [...this.stations.values()] }, null, 2)}\n`);
+        try {
+            this.onSaved?.();
+        }
+        catch { /* a listener's trouble is not the store's */ }
     }
     list() {
         return [...this.stations.values()].sort((a, b) => a.createdAt - b.createdAt);

package/dist/support.d.ts

@@ -20,6 +20,8 @@ export declare class Support {
         fetcher?: typeof fetch;
         now?: () => number;
     });
+    /** For a subscription's renewals, which ask CoinPay about their payments. */
+    get key(): string;
     holder(id: string): SupportHolder | undefined;
     get enabled(): boolean;
     private provider;
@@ -35,9 +37,72 @@ export declare class Support {
         coin?: unknown;
         station?: unknown;
         track?: unknown;
+        metadata?: Record<string, unknown>;
     }): Promise<{
         url: string;
+        paymentId: string;
     }>;
 }
 export declare const SUPPORT_PAGE: string;
 export declare const SUPPORT_CSP: string;
+/** Postgres, as nixamp.com's pool offers it. */
+export interface Db {
+    query: (text: string, params?: unknown[]) => Promise<{
+        rows: Array<Record<string, unknown>>;
+    }>;
+}
+/** One month on from a time, on the same day where the month has it. */
+export declare function nextMonth(at: number): number;
+/**
+ * Monthly support, run here rather than by CoinPay: CoinPay's only merchant
+ * subscriptions are Stripe's, and its recurring invoices refuse a scoped key.
+ * A subscription is an email, an amount, a coin and a holder. Month one is
+ * paid at once on CoinPay's checkout; each month after, a new payment is made
+ * and its link emailed, with a one-click cancel. A month left unpaid ends it
+ * (lapsed) rather than emailing forever.
+ */
+export declare class SupportSubscriptions {
+    private readonly options;
+    private schema;
+    private timer;
+    constructor(options: {
+        db: Db;
+        support: Support;
+        /** Resend; null leaves renewals unsent (and says so in the log). */
+        mail: {
+            apiKey: string;
+            from: string;
+        } | null;
+        site: string;
+        fetcher?: typeof fetch;
+        now?: () => number;
+        log?: (line: string) => void;
+    });
+    private now;
+    private ready;
+    /** Month one: a subscription and its first checkout. */
+    start(input: {
+        holder?: unknown;
+        amountUsd?: unknown;
+        coin?: unknown;
+        email?: unknown;
+        station?: unknown;
+        track?: unknown;
+    }): Promise<{
+        url: string;
+        id: string;
+    }>;
+    cancelLink(id: string, token: string): string;
+    cancel(id: string, token: string): Promise<{
+        canceled: boolean;
+        holder: string;
+    }>;
+    private paid;
+    /** Every subscription now due: a new month's payment and its link, or lapsed when last month went unpaid. */
+    renew(): Promise<{
+        renewed: number;
+        lapsed: number;
+    }>;
+    startSchedule(everyMs?: number): void;
+    private mail;
+}