nixamp 0.36.4 → 0.37.1

package/dist/station-cli.js

@@ -87,6 +87,7 @@ export async function station(argv) {
             `  state       ${String(station["state"])} (wanted ${String(station["desired"])})`,
             `  visibility  ${String(station["visibility"])}${station["listed"] ? ", listed in the directory" : ""}`,
             `  rotation    ${station["shuffle"] ? "shuffle" : "in order"}${station["repeat"] ? ", repeating" : ", once"}; ${station["items"]?.length ?? 0} files at ${String(station["bitrate"])} kbps`,
+            `  breaks      ${Number(station["breaksEvery"] ?? 0) > 0 ? `a spot every ${Math.round(Number(station["breaksEvery"]) / 60)} min, between entries` : "none"}`,
             ...(station["error"] ? [`  problem     ${String(station["error"])}`] : []),
             ...(station["excluded"]?.length ? [`  left out   ${station["excluded"].length} files (nixamp station retry)`] : []),
             ...(station["visibility"] !== "private" && links["page"] ? [`  listen      ${links["page"]}`] : []),
@@ -127,6 +128,7 @@ export async function station(argv) {
                     shuffle: has(argv, "--shuffle"),
                     repeat: !has(argv, "--no-repeat"),
                     ...(bitrate ? { bitrate: Number(bitrate) } : {}),
+                    ...(flag(argv, "--breaks") ? { breaksEvery: Number(flag(argv, "--breaks")) } : {}),
                 });
                 return show(answer, (body) => `Made (private, stopped):\n${describe(body["station"])}`);
             }
@@ -146,6 +148,17 @@ export async function station(argv) {
                     return 2;
                 return show(await call("POST", `/api/v1/stations/${station}/${command}`, {}), (body) => describe(body["station"]));
             }
+            case "breaks": {
+                const station = needId();
+                if (!station)
+                    return 2;
+                const seconds = argv.includes("--off") ? 0 : Number(argv[argv.indexOf(station) + 1]);
+                if (!Number.isFinite(seconds)) {
+                    console.error("nixamp station breaks ID SECONDS (or --off)");
+                    return 2;
+                }
+                return show(await call("PATCH", `/api/v1/stations/${station}`, { breaksEvery: seconds }), (body) => describe(body["station"]));
+            }
             case "publish": {
                 const station = needId();
                 if (!station)
@@ -230,6 +243,10 @@ export async function station(argv) {
                     ].join("\n");
                 });
             }
+            case "ai":
+                return await aiCommand(argv.slice(1), call, show, json);
+            case "shares":
+                return await sharesCommand(argv.slice(1), call, show);
             case "delete": {
                 const station = needId();
                 if (!station)
@@ -249,3 +266,165 @@ export async function station(argv) {
         throw error;
     }
 }
+async function readStdin() {
+    let text = "";
+    for await (const chunk of process.stdin)
+        text += String(chunk);
+    return text.trim();
+}
+/** `nixamp station ai ...` */
+async function aiCommand(argv, call, show, json) {
+    const [sub, key] = argv;
+    const describe = (one) => [
+        `${String(one["name"])}  [${String(one["key"])}]${one["enabled"] ? "" : "  (off)"}`,
+        `  style      ${String(one["style"])}`,
+        `  tracks     ${String(one["tracks"] ?? one["tracks"]?.length ?? 0)} of ${String(one["trackSeconds"])} s, ${String(one["perDay"])} a day${one["vocals"] ? ", with vocals" : ""}`,
+        `  station    ${one["stationId"] ? String(one["stationId"]) : "made with its first track"}${one["publish"] ? ", public on the guide" : ", unlisted"}`,
+        ...(one["lastError"] ? [`  problem    ${String(one["lastError"])}`] : []),
+    ].join("\n");
+    switch (sub) {
+        case undefined:
+        case "status":
+        case "list":
+            return show(await call("GET", "/api/v1/stations/ai"), (body) => {
+                const keys = (body["keys"] ?? {});
+                const stations = body["stations"] ?? [];
+                return [
+                    `composer   ${String(body["composer"] ?? "none")}; briefs by ${String(body["writer"])}`,
+                    `this month ${String(body["secondsThisMonth"])} of ${Number(body["monthlySeconds"]) === 0 ? "unlimited" : String(body["monthlySeconds"])} s${body["busy"] ? `; composing for ${String(body["busy"])}` : ""}`,
+                    ...(body["paused"] ? [`paused     ${String(body["paused"])}`] : []),
+                    `keys       ${Object.entries(keys).map(([name, set]) => `${name} ${set ? "set" : "-"}`).join(", ")}`,
+                    "",
+                    ...(stations.length ? stations.map(describe) : [`No AI stations yet. nixamp station ai create --preset ${(body["presets"] ?? ["lofi"])[0]}`]),
+                ].join("\n");
+            });
+        case "create": {
+            const seconds = flag(argv, "--seconds");
+            const perDay = flag(argv, "--per-day");
+            const body = {
+                ...(flag(argv, "--preset") ? { preset: flag(argv, "--preset") } : {}),
+                ...(flag(argv, "--name") ? { name: flag(argv, "--name") } : {}),
+                ...(flag(argv, "--style") ? { style: flag(argv, "--style") } : {}),
+                ...(flag(argv, "--description") ? { description: flag(argv, "--description") } : {}),
+                ...(has(argv, "--vocals") ? { vocals: true } : has(argv, "--instrumental") ? { vocals: false } : {}),
+                ...(seconds ? { trackSeconds: Number(seconds) } : {}),
+                ...(perDay ? { perDay: Number(perDay) } : {}),
+                publish: !has(argv, "--unlisted"),
+            };
+            return show(await call("POST", "/api/v1/stations/ai/stations", body), (answer) => `Made. Its first tracks are being composed now; the station appears with the first.\n${describe(answer["station"])}`);
+        }
+        case "generate": {
+            if (!key) {
+                console.error("nixamp station ai generate needs the AI station's key (nixamp station ai)");
+                return 2;
+            }
+            if (!json)
+                console.log("Composing; this takes a minute or two…");
+            return show(await call("POST", `/api/v1/stations/ai/stations/${key}/generate`, {}), (answer) => {
+                const track = answer["track"];
+                return `"${String(track["title"])}" (${String(track["seconds"])} s, ${String(track["made"])}) is on the station.`;
+            });
+        }
+        case "set": {
+            if (!key) {
+                console.error("nixamp station ai set needs the AI station's key");
+                return 2;
+            }
+            const body = {
+                ...(flag(argv, "--style") ? { style: flag(argv, "--style") } : {}),
+                ...(flag(argv, "--name") ? { name: flag(argv, "--name") } : {}),
+                ...(flag(argv, "--per-day") ? { perDay: Number(flag(argv, "--per-day")) } : {}),
+                ...(flag(argv, "--seconds") ? { trackSeconds: Number(flag(argv, "--seconds")) } : {}),
+                ...(has(argv, "--off") ? { enabled: false } : has(argv, "--on") ? { enabled: true } : {}),
+                ...(has(argv, "--vocals") ? { vocals: true } : has(argv, "--instrumental") ? { vocals: false } : {}),
+            };
+            return show(await call("PATCH", `/api/v1/stations/ai/stations/${key}`, body), (answer) => describe({ ...answer["station"], tracks: answer["station"]["tracks"].length }));
+        }
+        case "remove": {
+            if (!key) {
+                console.error("nixamp station ai remove needs the AI station's key");
+                return 2;
+            }
+            const files = has(argv, "--files");
+            return show(await call("DELETE", `/api/v1/stations/ai/stations/${key}${files ? "?files=1" : ""}`), () => files ? "Removed, with its station and its music." : "Removed. Its station and its music stay; nothing new will be composed.");
+        }
+        case "budget":
+            return show(await call("POST", "/api/v1/stations/ai", { monthlySeconds: Number(key) }), (answer) => {
+                const settings = answer["settings"];
+                return `AI music: at most ${Number(settings["monthlySeconds"]) === 0 ? "unlimited" : `${String(settings["monthlySeconds"])} s`} a month.`;
+            });
+        case "resume":
+            return show(await call("POST", "/api/v1/stations/ai", { resume: true }), () => "Composing again.");
+        case "key": {
+            if (!key) {
+                console.error("nixamp station ai key needs a name, e.g. ELEVENLABS_API_KEY, and the value on stdin");
+                return 2;
+            }
+            const value = has(argv, "--clear") ? "" : await readStdin();
+            return show(await call("POST", "/api/v1/stations/ai/keys", { name: key, value }), (answer) => `Keys: ${Object.entries((answer["keys"] ?? {})).map(([name, set]) => `${name} ${set ? "set" : "-"}`).join(", ")}`);
+        }
+        default:
+            console.error(`nixamp station ai: no command "${sub}".\n\n${USAGE}`);
+            return 2;
+    }
+}
+/** `nixamp station shares ...` */
+async function sharesCommand(argv, call, show) {
+    const [sub, id] = argv;
+    const line = (one) => `  ${String(one["id"])}  ${String(one["state"]).padEnd(9)} ${String(one["genre"] || "?").padEnd(14)} ${String(one["title"] || one["name"])}${one["artist"] ? ` — ${String(one["artist"])}` : ""}  [${String(one["rights"]?.["basis"] ?? "")}]${one["reason"] ? `\n      ${String(one["reason"])}` : ""}`;
+    const summary = (body) => {
+        const setting = (body["setting"] ?? {});
+        const shares = body["shares"] ?? [];
+        return [
+            `shares     ${setting["open"] ? "open" : "closed"}; moderation ${String(setting["moderation"])}${setting["model"] ? "" : " (no AI key: everything waits for you)"}; ${setting["publish"] ? "public on the guide" : "unlisted"}; ${Math.round(Number(setting["maxBytes"]) / 1048576)} MB, ${String(setting["perHour"])} an hour each`,
+            ...(shares.length ? ["", ...shares.map(line)] : []),
+        ].join("\n");
+    };
+    switch (sub) {
+        case undefined:
+        case "list": {
+            const state = flag(argv, "--state");
+            return show(await call("GET", `/api/v1/stations/shares${state ? `?state=${encodeURIComponent(state)}` : sub === undefined ? "?state=held" : ""}`), summary);
+        }
+        case "on":
+        case "off": {
+            const body = sub === "off" ? { open: false } : {
+                open: true,
+                moderation: has(argv, "--owner-moderation") ? "owner" : "ai",
+                publish: !has(argv, "--unlisted"),
+                ...(flag(argv, "--max-mb") ? { maxMb: Number(flag(argv, "--max-mb")) } : {}),
+                ...(flag(argv, "--per-hour") ? { perHour: Number(flag(argv, "--per-hour")) } : {}),
+            };
+            return show(await call("POST", "/api/v1/stations/shares", body), (answer) => summary(answer));
+        }
+        case "approve":
+        case "reject": {
+            if (!id) {
+                console.error(`nixamp station shares ${sub} needs a share id`);
+                return 2;
+            }
+            return show(await call("POST", `/api/v1/stations/shares/${id}/${sub}`, { reason: flag(argv, "--reason") ?? "" }), (answer) => line(answer["share"]));
+        }
+        case "delete": {
+            if (!id) {
+                console.error("nixamp station shares delete needs a share id");
+                return 2;
+            }
+            return show(await call("DELETE", `/api/v1/stations/shares/${id}`), () => `Deleted ${id} and its copy.`);
+        }
+        case "trust": {
+            const { readConfig, writeConfig } = await import("./library.js");
+            const proxies = new Set(readConfig().trustedProxies ?? []);
+            if (argv.includes("--remove"))
+                proxies.delete(id ?? "");
+            else if (id)
+                proxies.add(id);
+            writeConfig({ trustedProxies: [...proxies] });
+            console.log(proxies.size ? `X-Forwarded-For believed from: ${[...proxies].join(", ")}` : "No proxy is trusted.");
+            return 0;
+        }
+        default:
+            console.error(`nixamp station shares: no command "${sub}".\n\n${USAGE}`);
+            return 2;
+    }
+}

package/dist/station-guide.d.ts

@@ -1,6 +1,9 @@
 export interface GuideEntry {
+    id?: string;
     name: string;
     kind: "audio" | "video";
+    /** ai, shared, radio or tv; from kind when absent. */
+    group?: "ai" | "shared" | "radio" | "tv";
     state: string;
     page: string;
     nowPlaying: {
@@ -14,7 +17,7 @@ export interface GuideEntry {
  * /n/<name>), and for a crawler. Everything from a station is escaped.
  */
 export declare function renderGuide(entries: GuideEntry[]): string;
-export declare const GUIDE_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<title>Live \u00B7 stations</title>\n<meta name=\"description\" content=\"Radio and TV stations, live now.\">\n<link rel=\"icon\" href=\"data:,\">\n<style>\n:root{--bg:#f6f5f2;--fg:#17171a;--muted:#5d5d66;--card:#fff;--line:#dedcd6;--accent:#1f6feb;--live:#0b7a3b}\n@media (prefers-color-scheme:dark){:root{--bg:#121214;--fg:#ececf1;--muted:#a4a4b0;--card:#1c1c20;--line:#2c2c33;--accent:#6aa7ff;--live:#3fbf7f}}\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:880px;margin:0 auto;padding:40px 16px}\nh1{margin:0 0 4px;font-size:1.8rem}p.lead{color:var(--muted);margin:0 0 24px}\nh2{font-size:1rem;letter-spacing:.06em;text-transform:uppercase;color:var(--muted);margin:28px 0 10px}\n.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:12px}\na.station{display:block;background:var(--card);border:1px solid var(--line);border-radius:14px;padding:16px;color:inherit;text-decoration:none}\na.station:hover,a.station:focus-visible{border-color:var(--accent);outline:none}\n.name{font-weight:700;font-size:1.05rem}.now{color:var(--muted);font-size:.9rem;margin-top:6px;min-height:1.4em}\n.live{color:var(--live);font-size:.8rem;font-weight:700}.empty{color:var(--muted)}\nfooter{margin-top:40px;color:var(--muted);font-size:.85rem}footer a{color:inherit}\n</style>\n</head>\n<body>\n<main>\n  <h1>Live</h1>\n  <p class=\"lead\">Radio and TV, on the air now. Pick one and press play.</p>\n  <h2 id=\"radio-title\" hidden>Radio</h2>\n  <div id=\"radio\" class=\"grid\" aria-live=\"polite\"></div>\n  <h2 id=\"tv-title\" hidden>TV</h2>\n  <div id=\"tv\" class=\"grid\" aria-live=\"polite\"></div>\n  <p id=\"empty\" class=\"empty\">Nothing is on the air here yet.</p>\n  <footer>Played by <a href=\"https://nixamp.com\">nixamp</a>, on the Moshpit.</footer>\n</main>\n<script>\n(async () => {\n  const el = (tag, cls, text) => { const n = document.createElement(tag); if (cls) n.className = cls; if (text) n.textContent = text; return n; };\n  const draw = (stations) => {\n    for (const [kind, box] of [[\"audio\", \"#radio\"], [\"video\", \"#tv\"]]) {\n      const grid = document.querySelector(box);\n      grid.replaceChildren();\n      const list = stations.filter((s) => s.kind === kind);\n      document.querySelector(box + \"-title\").hidden = list.length === 0;\n      for (const s of list) {\n        const a = el(\"a\", \"station\");\n        a.href = s.page;\n        a.append(el(\"div\", \"live\", s.state === \"live\" ? \"\u25CF LIVE\" : \"off the air\"), el(\"div\", \"name\", s.name),\n          el(\"div\", \"now\", s.nowPlaying ? [s.nowPlaying.title, s.nowPlaying.artist].filter(Boolean).join(\" \u2014 \") : \"\"));\n        grid.append(a);\n      }\n    }\n    document.querySelector(\"#empty\").hidden = stations.length > 0;\n  };\n  const load = async () => {\n    try {\n      const r = await fetch(\"/api/v1/stations/guide\", { cache: \"no-store\" });\n      if (r.ok && (r.headers.get(\"content-type\") || \"\").includes(\"json\")) draw((await r.json()).stations);\n    } catch {}\n  };\n  await load();\n  setInterval(load, 15000);\n})();\n</script>\n</body>\n</html>\n";
+export declare const GUIDE_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<title>Live \u00B7 stations</title>\n<meta name=\"description\" content=\"Radio and TV stations, live now: AI-composed music, tracks shared by listeners, and more.\">\n<link rel=\"icon\" href=\"data:,\">\n<style>\n:root{--bg:#f6f5f2;--fg:#17171a;--muted:#5d5d66;--card:#fff;--line:#dedcd6;--accent:#1f6feb;--live:#0b7a3b;--warn:#a1460b}\n@media (prefers-color-scheme:dark){:root{--bg:#121214;--fg:#ececf1;--muted:#a4a4b0;--card:#1c1c20;--line:#2c2c33;--accent:#6aa7ff;--live:#3fbf7f;--warn:#f0a35e}}\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:880px;margin:0 auto;padding:40px 16px}\nh1{margin:0 0 4px;font-size:1.8rem}p.lead{color:var(--muted);margin:0 0 24px}\nh2{font-size:1rem;letter-spacing:.06em;text-transform:uppercase;color:var(--muted);margin:28px 0 10px}\n.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:12px}\n.card{background:var(--card);border:1px solid var(--line);border-radius:14px;padding:16px;position:relative}\n.card:hover,.card:focus-within{border-color:var(--accent)}\na.station{color:inherit;text-decoration:none;display:block}a.station:focus-visible{outline:2px solid var(--accent);outline-offset:4px;border-radius:6px}\n.name{font-weight:700;font-size:1.05rem}.now{color:var(--muted);font-size:.9rem;margin-top:6px;min-height:1.4em}\n.live{color:var(--live);font-size:.8rem;font-weight:700}.empty{color:var(--muted)}\nbutton.report{margin-top:10px;background:none;border:0;padding:0;color:var(--muted);font:inherit;font-size:.8rem;text-decoration:underline;cursor:pointer}\nbutton.report:hover{color:var(--warn)}\n#share{background:var(--card);border:1px solid var(--line);border-radius:14px;padding:16px;margin-top:12px}\n#share label{display:block;font-size:.9rem;margin:10px 0 4px;color:var(--muted)}\n#share input[type=url],#share input[type=text],#share select{width:100%;padding:9px 10px;border:1px solid var(--line);border-radius:8px;background:var(--bg);color:var(--fg);font:inherit}\n#share .agree{display:flex;gap:8px;align-items:flex-start;color:var(--fg);margin-top:12px}\n#share button[type=submit]{margin-top:14px;background:var(--accent);color:#fff;border:0;border-radius:8px;padding:10px 16px;font:inherit;font-weight:600;cursor:pointer}\n#share .or{color:var(--muted);font-size:.85rem;margin:8px 0 0}\n#status{margin-top:10px;font-size:.9rem;min-height:1.4em}\nfooter{margin-top:40px;color:var(--muted);font-size:.85rem}footer a{color:inherit}\n</style>\n</head>\n<body>\n<main>\n  <h1>Live</h1>\n  <p class=\"lead\">Radio and TV, on the air now. Pick one and press play.</p>\n  <h2 id=\"ai-title\" hidden>AI Radio</h2>\n  <div id=\"ai\" class=\"grid\" aria-live=\"polite\"></div>\n  <h2 id=\"shared-title\" hidden>Shared by listeners</h2>\n  <div id=\"shared\" class=\"grid\" aria-live=\"polite\"></div>\n  <h2 id=\"radio-title\" hidden>Radio</h2>\n  <div id=\"radio\" class=\"grid\" aria-live=\"polite\"></div>\n  <h2 id=\"tv-title\" hidden>TV</h2>\n  <div id=\"tv\" class=\"grid\" aria-live=\"polite\"></div>\n  <p id=\"empty\" class=\"empty\">Nothing is on the air here yet.</p>\n  <h2 id=\"share-title\" hidden>Share a track</h2>\n  <form id=\"share\" hidden>\n    <label for=\"url\">A link to an MP3</label>\n    <input id=\"url\" name=\"url\" type=\"url\" placeholder=\"https://example.com/my-song.mp3\" inputmode=\"url\">\n    <p class=\"or\">or upload one (up to <span id=\"max\">60 MB</span>)</p>\n    <input id=\"file\" name=\"file\" type=\"file\" accept=\"audio/*,.mp3,.ogg,.flac,.m4a,.wav\">\n    <label for=\"basis\">Why it may be broadcast</label>\n    <select id=\"basis\" name=\"basis\" required>\n      <option value=\"owned\">I made it</option>\n      <option value=\"permission\">I have the artist's permission</option>\n      <option value=\"licensed\">It is licensed for broadcast</option>\n      <option value=\"creative-commons\">It is Creative Commons (allows sharing)</option>\n      <option value=\"public-domain\">It is in the public domain</option>\n    </select>\n    <label for=\"note\">Anything we should know (licence, link to the artist)</label>\n    <input id=\"note\" name=\"note\" type=\"text\" maxlength=\"300\">\n    <label for=\"by\">Credit me as (optional)</label>\n    <input id=\"by\" name=\"by\" type=\"text\" maxlength=\"60\">\n    <label class=\"agree\"><input type=\"checkbox\" name=\"agree\" value=\"1\"> I have the right to share this for broadcast here. AI files it under a genre and checks it before it airs; anything can be reported off the air.</label>\n    <button type=\"submit\">Share it</button>\n    <div id=\"status\" role=\"status\" aria-live=\"polite\"></div>\n  </form>\n  <footer>Played by <a href=\"https://nixamp.com\">nixamp</a>, on the Moshpit.</footer>\n</main>\n<script>\n(async () => {\n  const el = (tag, cls, text) => { const n = document.createElement(tag); if (cls) n.className = cls; if (text) n.textContent = text; return n; };\n  const say = (text) => { document.querySelector(\"#status\").textContent = text; };\n  const report = async (id, button) => {\n    if (!confirm(\"Report the track playing now? It comes off the air until the owner looks at it.\")) return;\n    button.disabled = true;\n    try {\n      const r = await fetch(\"/api/v1/share/report\", { method: \"POST\", headers: { \"content-type\": \"application/json\" }, body: JSON.stringify({ station: id }) });\n      const body = await r.json();\n      button.textContent = body.reported ? \"Reported: off the air\" : \"Nothing shared is playing\";\n    } catch { button.textContent = \"Could not report; try again\"; button.disabled = false; }\n  };\n  const draw = (stations) => {\n    for (const group of [\"ai\", \"shared\", \"radio\", \"tv\"]) {\n      const grid = document.querySelector(\"#\" + group);\n      grid.replaceChildren();\n      const list = stations.filter((s) => (s.group || (s.kind === \"video\" ? \"tv\" : \"radio\")) === group);\n      document.querySelector(\"#\" + group + \"-title\").hidden = list.length === 0;\n      for (const s of list) {\n        const card = el(\"div\", \"card\");\n        const a = el(\"a\", \"station\");\n        a.href = s.page;\n        a.append(el(\"div\", \"live\", s.state === \"live\" ? \"\u25CF LIVE\" : \"off the air\"), el(\"div\", \"name\", s.name),\n          el(\"div\", \"now\", s.nowPlaying ? [s.nowPlaying.title, s.nowPlaying.artist].filter(Boolean).join(\" \u2014 \") : \"\"));\n        card.append(a);\n        if (group === \"shared\") {\n          const b = el(\"button\", \"report\", \"Report this track\");\n          b.type = \"button\";\n          b.addEventListener(\"click\", () => report(s.id, b));\n          card.append(b);\n        }\n        grid.append(card);\n      }\n    }\n    document.querySelector(\"#empty\").hidden = stations.length > 0;\n  };\n  const load = async () => {\n    try {\n      const r = await fetch(\"/api/v1/stations/guide\", { cache: \"no-store\" });\n      if (r.ok && (r.headers.get(\"content-type\") || \"\").includes(\"json\")) draw((await r.json()).stations);\n    } catch {}\n  };\n  const watch = async (status) => {\n    for (let i = 0; i < 120; i++) {\n      await new Promise((done) => setTimeout(done, 3000));\n      try {\n        const share = (await (await fetch(status, { cache: \"no-store\" })).json()).share;\n        if (!share) return;\n        const words = { fetching: \"Fetching it\u2026\", checking: \"Listening to it and checking it\u2026\", held: \"Waiting for the owner to look at it\", approved: \"On the air\", rejected: \"Not accepted\", failed: \"Could not use it\", withdrawn: \"Withdrawn\", reported: \"Reported\" };\n        say((words[share.state] || share.state) + (share.genre ? \" \u00B7 \" + share.genre : \"\") + (share.reason ? \" \u2014 \" + share.reason : \"\"));\n        if (![\"fetching\", \"checking\"].includes(share.state)) { load(); return; }\n      } catch {}\n    }\n  };\n  const form = document.querySelector(\"#share\");\n  try {\n    const info = await (await fetch(\"/api/v1/share\", { cache: \"no-store\" })).json();\n    if (info.open) {\n      document.querySelector(\"#share-title\").hidden = false;\n      form.hidden = false;\n      document.querySelector(\"#max\").textContent = info.maxMb + \" MB\";\n    }\n  } catch {}\n  form.addEventListener(\"submit\", async (event) => {\n    event.preventDefault();\n    const data = new FormData(form);\n    const file = data.get(\"file\");\n    const link = String(data.get(\"url\") || \"\").trim();\n    const fields = { basis: String(data.get(\"basis\") || \"\"), note: String(data.get(\"note\") || \"\"), by: String(data.get(\"by\") || \"\"), agree: data.get(\"agree\") ? \"1\" : \"\" };\n    if (!fields.agree) { say(\"Tick the box to confirm you have the right to share it.\"); return; }\n    if (!link && !(file && file.size)) { say(\"Paste a link to an MP3, or choose a file.\"); return; }\n    say(file && file.size && !link ? \"Uploading\u2026\" : \"Sending\u2026\");\n    try {\n      const r = file && file.size && !link\n        ? await fetch(\"/api/v1/share/upload?\" + new URLSearchParams({ ...fields, name: file.name }), { method: \"PUT\", headers: { \"content-type\": file.type || \"audio/mpeg\" }, body: file })\n        : await fetch(\"/api/v1/share\", { method: \"POST\", headers: { \"content-type\": \"application/json\" }, body: JSON.stringify({ ...fields, agree: true, url: link }) });\n      const body = await r.json();\n      if (!r.ok) { say(body.error || \"That did not work.\"); return; }\n      form.reset();\n      say(\"Got it. Checking it now\u2026\");\n      watch(body.status);\n    } catch { say(\"Could not reach the station; try again.\"); }\n  });\n  await load();\n  setInterval(load, 15000);\n})();\n</script>\n</body>\n</html>\n";
 export declare const GUIDE_CSP: string;
 /**
  * The hosts whose front page is the guide: `guideHosts` in config.json

package/dist/station-guide.js

@@ -9,34 +9,62 @@
 import { createHash } from "node:crypto";
 import { readConfig } from "./library.js";
 const STYLE = `
-:root{--bg:#f6f5f2;--fg:#17171a;--muted:#5d5d66;--card:#fff;--line:#dedcd6;--accent:#1f6feb;--live:#0b7a3b}
-@media (prefers-color-scheme:dark){:root{--bg:#121214;--fg:#ececf1;--muted:#a4a4b0;--card:#1c1c20;--line:#2c2c33;--accent:#6aa7ff;--live:#3fbf7f}}
+:root{--bg:#f6f5f2;--fg:#17171a;--muted:#5d5d66;--card:#fff;--line:#dedcd6;--accent:#1f6feb;--live:#0b7a3b;--warn:#a1460b}
+@media (prefers-color-scheme:dark){:root{--bg:#121214;--fg:#ececf1;--muted:#a4a4b0;--card:#1c1c20;--line:#2c2c33;--accent:#6aa7ff;--live:#3fbf7f;--warn:#f0a35e}}
 *{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}
 main{max-width:880px;margin:0 auto;padding:40px 16px}
 h1{margin:0 0 4px;font-size:1.8rem}p.lead{color:var(--muted);margin:0 0 24px}
 h2{font-size:1rem;letter-spacing:.06em;text-transform:uppercase;color:var(--muted);margin:28px 0 10px}
 .grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:12px}
-a.station{display:block;background:var(--card);border:1px solid var(--line);border-radius:14px;padding:16px;color:inherit;text-decoration:none}
-a.station:hover,a.station:focus-visible{border-color:var(--accent);outline:none}
+.card{background:var(--card);border:1px solid var(--line);border-radius:14px;padding:16px;position:relative}
+.card:hover,.card:focus-within{border-color:var(--accent)}
+a.station{color:inherit;text-decoration:none;display:block}a.station:focus-visible{outline:2px solid var(--accent);outline-offset:4px;border-radius:6px}
 .name{font-weight:700;font-size:1.05rem}.now{color:var(--muted);font-size:.9rem;margin-top:6px;min-height:1.4em}
 .live{color:var(--live);font-size:.8rem;font-weight:700}.empty{color:var(--muted)}
+button.report{margin-top:10px;background:none;border:0;padding:0;color:var(--muted);font:inherit;font-size:.8rem;text-decoration:underline;cursor:pointer}
+button.report:hover{color:var(--warn)}
+#share{background:var(--card);border:1px solid var(--line);border-radius:14px;padding:16px;margin-top:12px}
+#share label{display:block;font-size:.9rem;margin:10px 0 4px;color:var(--muted)}
+#share input[type=url],#share input[type=text],#share select{width:100%;padding:9px 10px;border:1px solid var(--line);border-radius:8px;background:var(--bg);color:var(--fg);font:inherit}
+#share .agree{display:flex;gap:8px;align-items:flex-start;color:var(--fg);margin-top:12px}
+#share button[type=submit]{margin-top:14px;background:var(--accent);color:#fff;border:0;border-radius:8px;padding:10px 16px;font:inherit;font-weight:600;cursor:pointer}
+#share .or{color:var(--muted);font-size:.85rem;margin:8px 0 0}
+#status{margin-top:10px;font-size:.9rem;min-height:1.4em}
 footer{margin-top:40px;color:var(--muted);font-size:.85rem}footer a{color:inherit}
 `;
 const SCRIPT = `
 (async () => {
   const el = (tag, cls, text) => { const n = document.createElement(tag); if (cls) n.className = cls; if (text) n.textContent = text; return n; };
+  const say = (text) => { document.querySelector("#status").textContent = text; };
+  const report = async (id, button) => {
+    if (!confirm("Report the track playing now? It comes off the air until the owner looks at it.")) return;
+    button.disabled = true;
+    try {
+      const r = await fetch("/api/v1/share/report", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ station: id }) });
+      const body = await r.json();
+      button.textContent = body.reported ? "Reported: off the air" : "Nothing shared is playing";
+    } catch { button.textContent = "Could not report; try again"; button.disabled = false; }
+  };
   const draw = (stations) => {
-    for (const [kind, box] of [["audio", "#radio"], ["video", "#tv"]]) {
-      const grid = document.querySelector(box);
+    for (const group of ["ai", "shared", "radio", "tv"]) {
+      const grid = document.querySelector("#" + group);
       grid.replaceChildren();
-      const list = stations.filter((s) => s.kind === kind);
-      document.querySelector(box + "-title").hidden = list.length === 0;
+      const list = stations.filter((s) => (s.group || (s.kind === "video" ? "tv" : "radio")) === group);
+      document.querySelector("#" + group + "-title").hidden = list.length === 0;
       for (const s of list) {
+        const card = el("div", "card");
         const a = el("a", "station");
         a.href = s.page;
         a.append(el("div", "live", s.state === "live" ? "● LIVE" : "off the air"), el("div", "name", s.name),
           el("div", "now", s.nowPlaying ? [s.nowPlaying.title, s.nowPlaying.artist].filter(Boolean).join(" — ") : ""));
-        grid.append(a);
+        card.append(a);
+        if (group === "shared") {
+          const b = el("button", "report", "Report this track");
+          b.type = "button";
+          b.addEventListener("click", () => report(s.id, b));
+          card.append(b);
+        }
+        grid.append(card);
       }
     }
     document.querySelector("#empty").hidden = stations.length > 0;
@@ -47,6 +75,47 @@ const SCRIPT = `
       if (r.ok && (r.headers.get("content-type") || "").includes("json")) draw((await r.json()).stations);
     } catch {}
   };
+  const watch = async (status) => {
+    for (let i = 0; i < 120; i++) {
+      await new Promise((done) => setTimeout(done, 3000));
+      try {
+        const share = (await (await fetch(status, { cache: "no-store" })).json()).share;
+        if (!share) return;
+        const words = { fetching: "Fetching it…", checking: "Listening to it and checking it…", held: "Waiting for the owner to look at it", approved: "On the air", rejected: "Not accepted", failed: "Could not use it", withdrawn: "Withdrawn", reported: "Reported" };
+        say((words[share.state] || share.state) + (share.genre ? " · " + share.genre : "") + (share.reason ? " — " + share.reason : ""));
+        if (!["fetching", "checking"].includes(share.state)) { load(); return; }
+      } catch {}
+    }
+  };
+  const form = document.querySelector("#share");
+  try {
+    const info = await (await fetch("/api/v1/share", { cache: "no-store" })).json();
+    if (info.open) {
+      document.querySelector("#share-title").hidden = false;
+      form.hidden = false;
+      document.querySelector("#max").textContent = info.maxMb + " MB";
+    }
+  } catch {}
+  form.addEventListener("submit", async (event) => {
+    event.preventDefault();
+    const data = new FormData(form);
+    const file = data.get("file");
+    const link = String(data.get("url") || "").trim();
+    const fields = { basis: String(data.get("basis") || ""), note: String(data.get("note") || ""), by: String(data.get("by") || ""), agree: data.get("agree") ? "1" : "" };
+    if (!fields.agree) { say("Tick the box to confirm you have the right to share it."); return; }
+    if (!link && !(file && file.size)) { say("Paste a link to an MP3, or choose a file."); return; }
+    say(file && file.size && !link ? "Uploading…" : "Sending…");
+    try {
+      const r = file && file.size && !link
+        ? await fetch("/api/v1/share/upload?" + new URLSearchParams({ ...fields, name: file.name }), { method: "PUT", headers: { "content-type": file.type || "audio/mpeg" }, body: file })
+        : await fetch("/api/v1/share", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ ...fields, agree: true, url: link }) });
+      const body = await r.json();
+      if (!r.ok) { say(body.error || "That did not work."); return; }
+      form.reset();
+      say("Got it. Checking it now…");
+      watch(body.status);
+    } catch { say("Could not reach the station; try again."); }
+  });
   await load();
   setInterval(load, 15000);
 })();
@@ -55,24 +124,26 @@ const hash = (text) => `'sha256-${createHash("sha256").update(text).digest("base
 function escape(text) {
     return text.replace(/[&<>"']/g, (one) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[one]);
 }
+const GROUPS = ["ai", "shared", "radio", "tv"];
 /**
  * The guide with its stations already in it, so it reads the same through a
  * gateway that cannot run its script against this server (the Moshpit's
  * /n/<name>), and for a crawler. Everything from a station is escaped.
  */
 export function renderGuide(entries) {
-    const cards = (kind) => entries
-        .filter((one) => one.kind === kind && /^https?:\/\//.test(one.page))
-        .map((one) => `<a class="station" href="${escape(one.page)}"><div class="live">${one.state === "live" ? "● LIVE" : "off the air"}</div><div class="name">${escape(one.name)}</div><div class="now">${one.nowPlaying ? escape([one.nowPlaying.title, one.nowPlaying.artist].filter(Boolean).join(" — ")) : ""}</div></a>`)
+    const groupOf = (one) => one.group ?? (one.kind === "video" ? "tv" : "radio");
+    const cards = (group) => entries
+        .filter((one) => groupOf(one) === group && /^https?:\/\//.test(one.page))
+        .map((one) => `<div class="card"><a class="station" href="${escape(one.page)}"><div class="live">${one.state === "live" ? "● LIVE" : "off the air"}</div><div class="name">${escape(one.name)}</div><div class="now">${one.nowPlaying ? escape([one.nowPlaying.title, one.nowPlaying.artist].filter(Boolean).join(" — ")) : ""}</div></a></div>`)
         .join("");
-    const radio = cards("audio");
-    const tv = cards("video");
-    return GUIDE_HTML
-        .replace('<h2 id="radio-title" hidden>', radio ? '<h2 id="radio-title">' : '<h2 id="radio-title" hidden>')
-        .replace('<div id="radio" class="grid" aria-live="polite"></div>', `<div id="radio" class="grid" aria-live="polite">${radio}</div>`)
-        .replace('<h2 id="tv-title" hidden>', tv ? '<h2 id="tv-title">' : '<h2 id="tv-title" hidden>')
-        .replace('<div id="tv" class="grid" aria-live="polite"></div>', `<div id="tv" class="grid" aria-live="polite">${tv}</div>`)
-        .replace('<p id="empty" class="empty">', entries.length ? '<p id="empty" class="empty" hidden>' : '<p id="empty" class="empty">');
+    let page = GUIDE_HTML;
+    for (const group of GROUPS) {
+        const made = cards(group);
+        page = page
+            .replace(`<h2 id="${group}-title" hidden>`, made ? `<h2 id="${group}-title">` : `<h2 id="${group}-title" hidden>`)
+            .replace(`<div id="${group}" class="grid" aria-live="polite"></div>`, `<div id="${group}" class="grid" aria-live="polite">${made}</div>`);
+    }
+    return page.replace('<p id="empty" class="empty">', entries.length ? '<p id="empty" class="empty" hidden>' : '<p id="empty" class="empty">');
 }
 export const GUIDE_HTML = `<!doctype html>
 <html lang="en">
@@ -80,7 +151,7 @@ export const GUIDE_HTML = `<!doctype html>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Live · stations</title>
-<meta name="description" content="Radio and TV stations, live now.">
+<meta name="description" content="Radio and TV stations, live now: AI-composed music, tracks shared by listeners, and more.">
 <link rel="icon" href="data:,">
 <style>${STYLE}</style>
 </head>
@@ -88,11 +159,37 @@ export const GUIDE_HTML = `<!doctype html>
 <main>
   <h1>Live</h1>
   <p class="lead">Radio and TV, on the air now. Pick one and press play.</p>
+  <h2 id="ai-title" hidden>AI Radio</h2>
+  <div id="ai" class="grid" aria-live="polite"></div>
+  <h2 id="shared-title" hidden>Shared by listeners</h2>
+  <div id="shared" class="grid" aria-live="polite"></div>
   <h2 id="radio-title" hidden>Radio</h2>
   <div id="radio" class="grid" aria-live="polite"></div>
   <h2 id="tv-title" hidden>TV</h2>
   <div id="tv" class="grid" aria-live="polite"></div>
   <p id="empty" class="empty">Nothing is on the air here yet.</p>
+  <h2 id="share-title" hidden>Share a track</h2>
+  <form id="share" hidden>
+    <label for="url">A link to an MP3</label>
+    <input id="url" name="url" type="url" placeholder="https://example.com/my-song.mp3" inputmode="url">
+    <p class="or">or upload one (up to <span id="max">60 MB</span>)</p>
+    <input id="file" name="file" type="file" accept="audio/*,.mp3,.ogg,.flac,.m4a,.wav">
+    <label for="basis">Why it may be broadcast</label>
+    <select id="basis" name="basis" required>
+      <option value="owned">I made it</option>
+      <option value="permission">I have the artist's permission</option>
+      <option value="licensed">It is licensed for broadcast</option>
+      <option value="creative-commons">It is Creative Commons (allows sharing)</option>
+      <option value="public-domain">It is in the public domain</option>
+    </select>
+    <label for="note">Anything we should know (licence, link to the artist)</label>
+    <input id="note" name="note" type="text" maxlength="300">
+    <label for="by">Credit me as (optional)</label>
+    <input id="by" name="by" type="text" maxlength="60">
+    <label class="agree"><input type="checkbox" name="agree" value="1"> I have the right to share this for broadcast here. AI files it under a genre and checks it before it airs; anything can be reported off the air.</label>
+    <button type="submit">Share it</button>
+    <div id="status" role="status" aria-live="polite"></div>
+  </form>
   <footer>Played by <a href="https://nixamp.com">nixamp</a>, on the Moshpit.</footer>
 </main>
 <script>${SCRIPT}</script>