nixamp 0.51.0 → 0.52.0

package/dist/music-cli.d.ts

@@ -0,0 +1,2 @@
+export declare const MUSIC_USAGE = "nixamp music: the AI label's songs as files (a song 10\u00A2, an album $1, everything by an artist $2; live radio is free)\n\n  nixamp music [list]                     what you bought, with its download link\n  nixamp music catalog [SERVER]           the artists, albums and songs (live.streaming by default)\n  nixamp music buy LINK                   a nixamp.com/buy link, or:\n  nixamp music buy --server URL --kind song|album|artist --artist KEY [--album KEY] [--n N]\n                   [--email you@example.com] [--coin SOL]      prints the CoinPay page to pay on\n  nixamp music download ID|all [--out DIR]   save the zip(s): MP3s with art and lyrics\n";
+export declare function music(argv: string[]): Promise<number>;

package/dist/music-cli.js

@@ -0,0 +1,109 @@
+/**
+ * `nixamp music`: the AI label's catalogue, buying, and what you bought.
+ *
+ *   nixamp music [list]                    what you bought (signed in with that email)
+ *   nixamp music catalog [SERVER]          artists, albums and songs (live.streaming by default)
+ *   nixamp music buy LINK|--server S --kind song|album|artist --artist A [--album B] [--n N]
+ *                    [--email E] [--coin SOL]   prints the CoinPay page to pay on
+ *   nixamp music download ID|all [--out DIR]   the zip(s) of what you bought
+ *
+ * Listening is free on the live stations; the files are sold: a song 10¢, an
+ * album $1, everything by an artist $2.
+ */
+import { buy, catalogue, download, fromBuyLink, PRICE_WORDS, purchases } from "./music-client.js";
+export const MUSIC_USAGE = `nixamp music: the AI label's songs as files (${PRICE_WORDS}; live radio is free)
+
+  nixamp music [list]                     what you bought, with its download link
+  nixamp music catalog [SERVER]           the artists, albums and songs (live.streaming by default)
+  nixamp music buy LINK                   a nixamp.com/buy link, or:
+  nixamp music buy --server URL --kind song|album|artist --artist KEY [--album KEY] [--n N]
+                   [--email you@example.com] [--coin SOL]      prints the CoinPay page to pay on
+  nixamp music download ID|all [--out DIR]   save the zip(s): MP3s with art and lyrics
+`;
+function flag(argv, name) {
+    const at = argv.indexOf(name);
+    return at === -1 ? undefined : argv[at + 1];
+}
+export async function music(argv) {
+    const [sub = "list", arg] = argv;
+    const json = argv.includes("--json");
+    try {
+        if (sub === "help" || argv.includes("--help")) {
+            console.log(MUSIC_USAGE);
+            return 0;
+        }
+        if (sub === "list") {
+            const mine = await purchases();
+            if (json) {
+                console.log(JSON.stringify(mine, null, 2));
+                return 0;
+            }
+            if (mine.purchases.length === 0) {
+                console.log(`Nothing bought yet for ${mine.email}. Every AI label song is for sale: ${PRICE_WORDS}.`);
+                return 0;
+            }
+            for (const one of mine.purchases)
+                console.log(`${one.id}  ${one.kind.padEnd(6)} ${one.title} · ${one.artistName}  ${new Date(one.paidAt).toISOString().slice(0, 10)}\n  ${one.zip ?? "(not paid yet)"}`);
+            return 0;
+        }
+        if (sub === "catalog" || sub === "catalogue") {
+            const view = await catalogue(arg && !arg.startsWith("--") ? arg : undefined);
+            if (json) {
+                console.log(JSON.stringify(view, null, 2));
+                return 0;
+            }
+            for (const genre of view.genres) {
+                console.log(`\n${genre.genre}${genre.station ? `  (live: /watch/${genre.station})` : ""}`);
+                for (const artist of genre.artists) {
+                    console.log(`  ${artist.name}  [${artist.key}]`);
+                    for (const album of artist.albums)
+                        console.log(`    ${album.year}  ${album.title}  [${album.key}]  ${album.songs.length} songs${album.complete ? "" : " (recording)"}`);
+                }
+            }
+            console.log(`\n℗ ${view.holder}. ${PRICE_WORDS}: nixamp music buy --server ${view.server ?? "URL"} --kind album --artist KEY --album KEY`);
+            return 0;
+        }
+        if (sub === "buy") {
+            const fromLink = arg && !arg.startsWith("--") ? fromBuyLink(arg) : null;
+            if (arg && !arg.startsWith("--") && !fromLink) {
+                console.error("nixamp music buy: that is not a nixamp.com/buy link");
+                return 2;
+            }
+            const input = {
+                ...(fromLink ?? { server: flag(argv, "--server"), kind: flag(argv, "--kind"), artist: flag(argv, "--artist"), album: flag(argv, "--album"), n: flag(argv, "--n") ? Number(flag(argv, "--n")) : undefined }),
+                coin: flag(argv, "--coin") ?? "USDC_POL",
+                ...(flag(argv, "--email") ? { email: flag(argv, "--email") } : {}),
+            };
+            if (typeof input["n"] === "string")
+                input["n"] = Number(input["n"]);
+            const made = await buy(input);
+            if (json) {
+                console.log(JSON.stringify(made, null, 2));
+                return 0;
+            }
+            console.log(`Pay here: ${made.url}\nYour receipt and download, once paid: ${made.receipt}`);
+            return 0;
+        }
+        if (sub === "download") {
+            if (!arg) {
+                console.error("nixamp music download needs a purchase id (nixamp music) or all");
+                return 2;
+            }
+            const mine = await purchases();
+            const chosen = arg === "all" ? mine.purchases : mine.purchases.filter((one) => one.id === arg);
+            if (chosen.length === 0) {
+                console.error(`nixamp music: no purchase ${arg}`);
+                return 1;
+            }
+            for (const one of chosen)
+                console.log(`saved ${await download(one, flag(argv, "--out") ?? ".")}`);
+            return 0;
+        }
+        console.error(`nixamp music: no command "${sub}".\n\n${MUSIC_USAGE}`);
+        return 2;
+    }
+    catch (error) {
+        console.error(`nixamp music: ${error.message}`);
+        return 1;
+    }
+}

package/dist/music-client.d.ts

@@ -0,0 +1,62 @@
+export declare const DEFAULT_CATALOGUE = "https://live.streaming.pit.world";
+export interface CatalogueSong {
+    n: number;
+    title: string;
+    seconds: number;
+    lyrics?: string;
+}
+export interface CatalogueAlbum {
+    key: string;
+    title: string;
+    year: number;
+    concept: string;
+    cover: boolean;
+    complete: boolean;
+    songs: CatalogueSong[];
+}
+export interface CatalogueArtist {
+    key: string;
+    name: string;
+    genre: string;
+    bio: string;
+    albums: CatalogueAlbum[];
+}
+export interface Catalogue {
+    holder: string;
+    server?: string;
+    genres: Array<{
+        genre: string;
+        station: string;
+        artists: CatalogueArtist[];
+    }>;
+}
+export interface Bought {
+    id: string;
+    kind: "song" | "album" | "artist";
+    title: string;
+    artistName: string;
+    server: string;
+    status: string;
+    paidAt: number;
+    amountUsd: number;
+    zip?: string;
+    link?: string;
+}
+type Fetcher = typeof fetch;
+export declare function catalogue(server?: string, fetcher?: Fetcher): Promise<Catalogue>;
+/** A /buy link read back into what it sells. */
+export declare function fromBuyLink(link: string): Record<string, string> | null;
+export declare function buy(input: Record<string, unknown>, fetcher?: Fetcher): Promise<{
+    url: string;
+    id: string;
+    token: string;
+    receipt: string;
+}>;
+export declare function purchases(fetcher?: Fetcher): Promise<{
+    email: string;
+    purchases: Bought[];
+}>;
+/** A purchase's zip, saved under `dir` with the name its server gives it. */
+export declare function download(one: Bought, dir: string, fetcher?: Fetcher): Promise<string>;
+export declare const PRICE_WORDS = "a song 10\u00A2, an album $1, everything by an artist $2";
+export {};

package/dist/music-client.js

@@ -0,0 +1,73 @@
+/**
+ * The AI label's catalogue and the music store, for the terminal and MCP.
+ *
+ * The catalogue is read from the server that holds the music (live.streaming
+ * by default); buying and what was bought are nixamp.com's (music-store.ts),
+ * with this machine's sign-in when there is one.
+ */
+import { createWriteStream, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { readSession } from "./session.js";
+export const DEFAULT_CATALOGUE = "https://live.streaming.pit.world";
+function site() {
+    return (readSession()?.site ?? process.env["NIXAMP_SITE"] ?? "https://nixamp.com").replace(/\/+$/, "");
+}
+function auth() {
+    const token = readSession()?.token;
+    return token ? { authorization: `Bearer ${token}` } : {};
+}
+export async function catalogue(server = DEFAULT_CATALOGUE, fetcher = fetch) {
+    const response = await fetcher(`${server.replace(/\/+$/, "")}/api/v1/label`, { signal: AbortSignal.timeout(15_000) });
+    if (!response.ok)
+        throw new Error(`${server} has no AI label catalogue (HTTP ${response.status})`);
+    return await response.json();
+}
+/** A /buy link read back into what it sells. */
+export function fromBuyLink(link) {
+    try {
+        const url = new URL(link);
+        if (url.pathname !== "/buy")
+            return null;
+        return Object.fromEntries(url.searchParams.entries());
+    }
+    catch {
+        return null;
+    }
+}
+export async function buy(input, fetcher = fetch) {
+    const response = await fetcher(`${site()}/api/v1/store/checkout`, {
+        method: "POST",
+        headers: { "content-type": "application/json", ...auth() },
+        body: JSON.stringify(input),
+    });
+    const body = await response.json().catch(() => ({}));
+    if (!response.ok || !body.url)
+        throw new Error(body.error ?? `nixamp.com answered ${response.status}`);
+    return { url: body.url, id: body.id ?? "", token: body.token ?? "", receipt: `${site()}/purchases/${body.id}?t=${body.token}` };
+}
+export async function purchases(fetcher = fetch) {
+    if (!readSession())
+        throw new Error("not signed in: run `nixamp login` (with the email you bought with)");
+    const response = await fetcher(`${site()}/api/v1/store/purchases`, { headers: auth() });
+    const body = await response.json().catch(() => ({}));
+    if (!response.ok)
+        throw new Error(body.error ?? `nixamp.com answered ${response.status}`);
+    return { email: body.email ?? "", purchases: body.purchases ?? [] };
+}
+/** A purchase's zip, saved under `dir` with the name its server gives it. */
+export async function download(one, dir, fetcher = fetch) {
+    if (!one.zip)
+        throw new Error(`"${one.title}" is not paid yet`);
+    const response = await fetcher(one.zip);
+    if (!response.ok || !response.body)
+        throw new Error(`the download of "${one.title}" answered HTTP ${response.status}`);
+    const named = /filename\*=UTF-8''([^;]+)/.exec(response.headers.get("content-disposition") ?? "")?.[1];
+    const name = (named ? decodeURIComponent(named) : `${one.artistName} - ${one.title}.zip`).replace(/[/\\]/g, "");
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, name);
+    await pipeline(Readable.fromWeb(response.body), createWriteStream(path));
+    return path;
+}
+export const PRICE_WORDS = "a song 10¢, an album $1, everything by an artist $2";

package/dist/station-cli.js

@@ -466,7 +466,9 @@ async function labelCommand(argv, call, show) {
                     `files      ${String(body["root"])}/<genre>/<artist>/<year>-<album>/`,
                     `composer   ${String(body["composer"] ?? "none")}; words by ${String(body["writer"] ?? "nobody (no model key)")}`,
                     `this month ${String(body["secondsThisMonth"])} of ${Number(settings["monthlySeconds"]) === 0 ? "unlimited" : String(settings["monthlySeconds"])} s${body["busy"] ? `; recording ${String(body["busy"])}` : ""}`,
-                    `albums     ${String(settings["songsPerAlbum"])} songs of ${String(settings["songSeconds"])} s; ${String(settings["seedAlbums"])} to start, then one every ${String(settings["everyDays"])} days`,
+                    `albums     ${String(settings["songsPerAlbum"])} songs of ${String(settings["songSeconds"])} s; ${String(settings["seedAlbums"])} to start, then one every ${String(settings["everyDays"])} days; ${String(settings["parallel"] ?? 1)} at a time`,
+                    `genres     ${(settings["genreOrder"] ?? []).join(", ")} first`,
+                    `after that ${Number(settings["albumsPerDay"] ?? 0) > 0 ? `${String(settings["albumsPerDay"])} album a day, a new artist ${Math.round(Number(settings["newArtistChance"] ?? 0) * 100)}% of the time` : `one per artist every ${String(settings["everyDays"])} days`}`,
                     ...(body["waiting"] ? [`waiting    ${String(body["waiting"])}`] : []),
                     "",
                     ...(artists.length ? artists.map(describe) : ["Nobody signed yet. nixamp station label sign --roster"]),
@@ -530,6 +532,11 @@ async function labelCommand(argv, call, show) {
                 seedAlbums: number("--seed-albums"),
                 songsPerAlbum: number("--songs"),
                 songSeconds: number("--seconds"),
+                parallel: number("--parallel"),
+                albumsPerDay: number("--per-day"),
+                videos: has(argv, "--no-videos") ? false : has(argv, "--videos") ? true : undefined,
+                newArtistChance: number("--new-artists"),
+                genreOrder: flag(argv, "--genres"),
                 enabled: has(argv, "--off") ? false : has(argv, "--on") ? true : undefined,
                 publish: has(argv, "--unlisted") ? false : has(argv, "--public") ? true : undefined,
             }).filter(([, value]) => value !== undefined));

package/dist/station-mcp.d.ts

@@ -46,6 +46,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -117,6 +121,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -211,6 +219,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -302,6 +314,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -375,6 +391,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -455,6 +475,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -535,6 +559,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -632,6 +660,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -738,6 +770,24 @@ export declare const STATION_TOOLS: ({
             songSeconds: {
                 type: string;
             };
+            parallel: {
+                type: string;
+            };
+            albumsPerDay: {
+                type: string;
+                description: string;
+            };
+            newArtistChance: {
+                type: string;
+                description: string;
+            };
+            genreOrder: {
+                type: string;
+                items: {
+                    readonly type: "string";
+                };
+                description: string;
+            };
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -798,6 +848,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             server: {
                 type: "string";
                 description: string;
@@ -887,6 +941,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;
@@ -978,6 +1036,10 @@ export declare const STATION_TOOLS: ({
             seedAlbums?: undefined;
             songsPerAlbum?: undefined;
             songSeconds?: undefined;
+            parallel?: undefined;
+            albumsPerDay?: undefined;
+            newArtistChance?: undefined;
+            genreOrder?: undefined;
             state?: undefined;
             reason?: undefined;
             open?: undefined;

package/dist/station-mcp.js

@@ -118,7 +118,10 @@ export const STATION_TOOLS = [
                 sound: { ...STRING, description: "The music in words: instruments, tempo, mood. Name no real artist." },
                 voice: STRING, bio: STRING, themes: STRING, enabled: { type: "boolean" }, publish: { type: "boolean" }, holder: STRING,
                 monthlySeconds: { type: "integer" }, everyDays: { type: "integer" }, seedAlbums: { type: "integer" },
-                songsPerAlbum: { type: "integer" }, songSeconds: { type: "integer" },
+                songsPerAlbum: { type: "integer" }, songSeconds: { type: "integer" }, parallel: { type: "integer" },
+                albumsPerDay: { type: "integer", description: "After the first sweep: new albums a day, by a random artist or a newly invented one." },
+                newArtistChance: { type: "number", description: "0-1: how often the day's album is by a new artist." },
+                genreOrder: { type: "array", items: STRING, description: "Genres whose artists get albums first, in order." },
             },
         },
     },
@@ -237,7 +240,7 @@ export async function callStationTool(name, args, options = {}) {
             const key = typeof args["key"] === "string" && /^[a-f0-9]{10}$/.test(args["key"]) ? args["key"] : "";
             const answer = action === "status" ? await call("GET", "/api/v1/stations/label")
                 : action === "sign" ? await call("POST", "/api/v1/stations/label/artists", pick(["preset", "roster", "name", "genre", "sound", "voice", "bio", "themes", "enabled"]))
-                    : action === "configure" ? await call("POST", "/api/v1/stations/label", pick(["holder", "monthlySeconds", "everyDays", "seedAlbums", "songsPerAlbum", "songSeconds", "enabled", "publish"]))
+                    : action === "configure" ? await call("POST", "/api/v1/stations/label", pick(["holder", "monthlySeconds", "everyDays", "seedAlbums", "songsPerAlbum", "songSeconds", "parallel", "genreOrder", "albumsPerDay", "newArtistChance", "enabled", "publish"]))
                         : action === "run" ? await call("POST", "/api/v1/stations/label/run", {})
                             : action === "resume" ? await call("POST", "/api/v1/stations/label", { resume: true })
                                 : !key ? null

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 (the default; 0 for none)]\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-ads [--site ID] [--slot ID] [--format banner_300x250|text_link] [--off]\n                     crawlproof analytics (project ID) and an ad unit (slot ID) on the guide\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),\n                                             NIXAMP_MUSIC_MODEL (music_v1|music_v2|music_v2_5), from stdin\n\n  AI label (AI artists who release albums on their own; a station per genre; the catalogue at /label):\n  nixamp station label                       artists, albums, this month's seconds, what it is waiting for\n  nixamp station label sign --roster         the roster: three artists in each of Rock, Hip-Hop, Synthwave, Country,\n                                             Metal and Pop (nixamp station label lists their keys)\n  nixamp station label sign (--preset KEY | --name NAME --genre GENRE --sound TEXT [--voice TEXT] [--bio TEXT] [--themes TEXT])\n  nixamp station label album KEY             plan the artist's next album now and record it\n  nixamp station label set KEY [--sound TEXT] [--voice TEXT] [--bio TEXT] [--themes TEXT] [--off|--on]\n  nixamp station label drop KEY [--files]\n  nixamp station label config [--holder \"Profullstack, Inc.\"] [--budget SECONDS] [--every-days 30] [--seed-albums 1]\n                              [--songs 8] [--seconds 150] [--on|--off] [--public|--unlisted]\n  nixamp station label run                   record whatever is due now\n  nixamp station label resume                after the provider ran out of credit\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.";
+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 (the default; 0 for none)]\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-ads [--site ID] [--slot ID] [--format banner_300x250|text_link] [--off]\n                     crawlproof analytics (project ID) and an ad unit (slot ID) on the guide\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),\n                                             NIXAMP_MUSIC_MODEL (music_v1|music_v2|music_v2_5), from stdin\n\n  AI label (AI artists who release albums on their own; a station per genre; the catalogue at /label):\n  nixamp station label                       artists, albums, this month's seconds, what it is waiting for\n  nixamp station label sign --roster         the roster: three artists in each of Rock, Hip-Hop, Synthwave, Country,\n                                             Metal and Pop (nixamp station label lists their keys)\n  nixamp station label sign (--preset KEY | --name NAME --genre GENRE --sound TEXT [--voice TEXT] [--bio TEXT] [--themes TEXT])\n  nixamp station label album KEY             plan the artist's next album now and record it\n  nixamp station label set KEY [--sound TEXT] [--voice TEXT] [--bio TEXT] [--themes TEXT] [--off|--on]\n  nixamp station label drop KEY [--files]\n  nixamp station label config [--holder \"Profullstack, Inc.\"] [--budget SECONDS] [--every-days 30] [--seed-albums 1]\n                              [--songs 8] [--seconds 150] [--on|--off] [--public|--unlisted]\n                              [--parallel 4] [--genres \"Punk,Blues,Country\"]   songs made at once; genres first\n                              [--per-day 1] [--new-artists 0.25]   after the first sweep: albums a day, share by new artists\n                              [--videos|--no-videos]   a music video per song and a TV station of them\n  nixamp station label run                   record whatever is due now\n  nixamp station label resume                after the provider ran out of credit\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

@@ -46,6 +46,9 @@ export const USAGE = `nixamp station — make a collection into a station
   nixamp station label drop KEY [--files]
   nixamp station label config [--holder "Profullstack, Inc."] [--budget SECONDS] [--every-days 30] [--seed-albums 1]
                               [--songs 8] [--seconds 150] [--on|--off] [--public|--unlisted]
+                              [--parallel 4] [--genres "Punk,Blues,Country"]   songs made at once; genres first
+                              [--per-day 1] [--new-artists 0.25]   after the first sweep: albums a day, share by new artists
+                              [--videos|--no-videos]   a music video per song and a TV station of them
   nixamp station label run                   record whatever is due now
   nixamp station label resume                after the provider ran out of credit
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nixamp",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "description": "It really whips the terminal's ass. A Winamp-shaped audio player for your terminal.",
   "license": "MIT",
   "type": "module",