nixamp 0.23.6 → 0.23.7

package/README.md

@@ -297,6 +297,18 @@ something else.
 Entries expire a few minutes after a stream stops renewing, so the list is
 always what is actually live.
 
+**A live that ends says so.** A film or a podcast that plays to its end, a
+list whose last entry did, or a publisher who stopped, used to start again
+from the top for ever. Now the channel plays its outro: five seconds of
+"THIS LIVE STREAM HAS ENDED" on the plate with the mark (a soft chime, on a
+channel with no picture), looped for an hour, so whoever joins late is told
+by the picture and by the page (an ENDED chip and a line in the Log), and
+the room's trollbox stays open. Then the channel closes on its own. The
+clip is drawn by the server itself with its ffmpeg the first time it is
+needed and kept beside the keys; **Start over** on the channel brings the
+show back from its beginning. A live feed that drops mid-stream is still
+dialled again, as before: only a clean end is an end.
+
 ## The trollbox, and saying a line out loud
 
 Every live room has a trollbox: the chat for whoever has joined that stream,

package/dist/channels.d.ts

@@ -80,6 +80,12 @@ export interface ChannelInfo {
      * plain URL is read this way, and only when a policy asks for it.
      */
     teed?: boolean;
+    /**
+     * When its show ended, wall clock, while the outro plays. A channel with
+     * this set is still on the air -- the picture says the stream has ended
+     * -- and closes on its own an hour later. Absent while the show is on.
+     */
+    ended?: number;
     /**
      * A picture of it from somewhere else: the thumbnail the site offered
      * for a pasted link, the logo a catalog gave a channel. A channel with
@@ -136,6 +142,8 @@ export declare const GIVE_UP = 5;
 export declare const STALL = 30000;
 /** How long an on-demand channel stays up with nobody watching. */
 export declare const IDLE = 60000;
+/** How long a channel plays its outro after the show, before it closes. */
+export declare const OUTRO_MS: number;
 /**
  * How much of the recent stream a newcomer is handed. About six seconds of
  * 720p television, and a couple of seconds of 192k MP3: enough to play
@@ -181,6 +189,16 @@ export interface ChannelOptions {
     ffmpeg: string[];
     onStart?: (info: ChannelInfo) => void;
     onEnd?: (info: ChannelInfo) => void;
+    /**
+     * The outro: the clip a channel plays once its show is over, by kind,
+     * encoded as the wire wants it (see outro.ts). Null, or absent, means a
+     * show that ends closes its channel as it always did.
+     */
+    outro?: (kind: "audio" | "video") => Promise<string | null>;
+    /** How long the outro plays before the channel closes. An hour. */
+    outroMs?: number;
+    /** Said once, when a show ends and the outro begins. */
+    onOutro?: (info: ChannelInfo) => void;
     /** How long an on-demand channel outlives its last viewer. Tests shorten it. */
     idleMs?: number;
     /** Unsent bytes a listener may hold before it is dropped. Tests shrink it. */
@@ -214,6 +232,11 @@ export declare class Channel {
     /** Fires when a pulled source has said nothing for STALL. */
     private watchdog;
     private stall;
+    /** Whether the outro is what is playing now: the show is over. */
+    private outroOn;
+    private outroTimer;
+    /** How the show was dialled, so a restart after the outro is the show again. */
+    private dialed;
     private stderr;
     /**
      * The last few seconds, for whoever joins next.
@@ -259,6 +282,14 @@ export declare class Channel {
      * in it is not a room anybody can be invited to.
      */
     pull(source: string, encode: string[], paced?: boolean, stall?: number, input?: string[], audio?: string, resume?: PullResume): void;
+    /**
+     * The show is over: the outro, then the end. A publisher's channel is
+     * told this when the publisher goes, so whoever joins in the next hour
+     * is shown that the stream has ended rather than nothing at all. Without
+     * an outro to play it is the same as close().
+     */
+    finish(): void;
+    private endShow;
     /**
      * Start the source over, now.
      *

package/dist/channels.js

@@ -40,6 +40,13 @@ export const GIVE_UP = 5;
 export const STALL = 30_000;
 /** How long an on-demand channel stays up with nobody watching. */
 export const IDLE = 60_000;
+/** How long a channel plays its outro after the show, before it closes. */
+export const OUTRO_MS = 60 * 60 * 1000;
+/** The encode the outro is copied through: what a channel sends on the wire. */
+const OUTRO_ENCODE = {
+    video: ["-c", "copy", "-f", "mp4", "-movflags", "frag_keyframe+empty_moov+default_base_moof"],
+    audio: ["-c", "copy", "-f", "mp3"],
+};
 /** How much of what ffmpeg said to keep, for the last line when it dies. */
 const TAIL = 2000;
 /**
@@ -140,6 +147,11 @@ export class Channel {
     /** Fires when a pulled source has said nothing for STALL. */
     watchdog = null;
     stall = STALL;
+    /** Whether the outro is what is playing now: the show is over. */
+    outroOn = false;
+    outroTimer = null;
+    /** How the show was dialled, so a restart after the outro is the show again. */
+    dialed = null;
     stderr = "";
     /**
      * The last few seconds, for whoever joins next.
@@ -219,6 +231,8 @@ export class Channel {
      */
     pull(source, encode, paced = true, stall = STALL, input = [], audio = "", resume = { live: true, position: 0 }) {
         this.stall = stall;
+        if (!this.outroOn)
+            this.dialed = { source, encode, paced, stall, input: [...input], audio, resume };
         if (this.info.kind === "video")
             this.fragments = new Fragments();
         const [command, ...prefix] = this.options.ffmpeg;
@@ -235,9 +249,13 @@ export class Channel {
             this.info.playlistAt = at;
         }
         let current = list ? list[at] : source;
+        // The last entry is the end of the show, not a way back to the first:
+        // a list that played through is over, and says so with the outro.
         this.advance = list && list.length > 1
             ? () => {
-                at = (at + 1) % list.length;
+                if (at + 1 >= list.length)
+                    return false;
+                at += 1;
                 this.info.playlistAt = at;
                 current = list[at];
                 return true;
@@ -267,7 +285,8 @@ export class Channel {
             // policy set after the channel started applies at its next restart.
             this.throughAbort?.abort();
             this.throughAbort = null;
-            const through = this.options.through?.(this.info, from, input, audio) ?? null;
+            // The outro is a file read by ffmpeg itself: a pipe cannot loop.
+            const through = this.outroOn ? null : this.options.through?.(this.info, from, input, audio) ?? null;
             this.info.teed = through !== null;
             const child = spawn(command, [
                 ...prefix,
@@ -362,7 +381,46 @@ export class Channel {
         };
         this.redial = dial;
         dial();
-        this.options.onStart?.(this.info);
+        if (!this.outroOn)
+            this.options.onStart?.(this.info);
+    }
+    /**
+     * The show is over: the outro, then the end. A publisher's channel is
+     * told this when the publisher goes, so whoever joins in the next hour
+     * is shown that the stream has ended rather than nothing at all. Without
+     * an outro to play it is the same as close().
+     */
+    finish() {
+        if (this.closing || this.outroOn)
+            return;
+        void this.endShow();
+    }
+    async endShow() {
+        const kind = this.info.kind ?? "audio";
+        const old = this.child;
+        this.child = null;
+        if (this.watchdog)
+            clearTimeout(this.watchdog);
+        this.watchdog = null;
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = null;
+        old?.kill("SIGKILL");
+        const clip = this.options.outro ? await this.options.outro(kind).catch(() => null) : null;
+        if (this.closing)
+            return;
+        if (!clip) {
+            this.close();
+            return;
+        }
+        this.outroOn = true;
+        this.info.ended = Date.now();
+        this.info.error = undefined;
+        this.startOver();
+        this.options.onOutro?.(this.info);
+        this.pull(clip, OUTRO_ENCODE[kind], true, this.stall, ["-stream_loop", "-1"], "", { live: true, position: 0 });
+        this.outroTimer = setTimeout(() => this.close(), this.options.outroMs ?? OUTRO_MS);
+        this.outroTimer.unref?.();
     }
     /**
      * Start the source over, now.
@@ -374,8 +432,28 @@ export class Channel {
      * strikes a dead CDN ran up an hour ago.
      */
     restart() {
+        if (this.closing)
+            return false;
+        // Started over from the outro: the show itself, from its beginning.
+        if (this.outroOn && this.dialed) {
+            this.outroOn = false;
+            delete this.info.ended;
+            if (this.outroTimer)
+                clearTimeout(this.outroTimer);
+            this.outroTimer = null;
+            const old = this.child;
+            this.child = null;
+            old?.kill("SIGKILL");
+            this.failures = 0;
+            this.info.error = undefined;
+            this.info.playlistAt = 0;
+            this.startOver();
+            const show = this.dialed;
+            this.pull(show.source, show.encode, show.paced, show.stall, show.input, show.audio, { ...show.resume, position: 0 });
+            return true;
+        }
         const dial = this.redial;
-        if (!dial || this.closing)
+        if (!dial)
             return false;
         if (this.timer)
             clearTimeout(this.timer);
@@ -469,6 +547,11 @@ export class Channel {
     dropped(sent) {
         if (this.closing || !this.redial)
             return;
+        // An outro that stopped is over; there is nothing after it.
+        if (this.outroOn) {
+            this.close();
+            return;
+        }
         this.child = null;
         if (this.watchdog)
             clearTimeout(this.watchdog);
@@ -486,6 +569,15 @@ export class Channel {
         // gave nothing is skipped the same way, counted as the failure it was,
         // so a list of dead links gives up rather than cycling for ever.
         const moved = this.advance?.() ?? false;
+        // A show that ended: a film or a podcast that played to its end, a
+        // list whose last entry did. That is not a source that dropped, and it
+        // is not dialled again from the top; it is over, and the outro says
+        // so. A live feed that stopped is a feed that dropped, and is redialled.
+        const list = (this.info.playlist?.length ?? 0) > 0;
+        if (sent && !moved && (this.info.live === false || list)) {
+            void this.endShow();
+            return;
+        }
         const ended = moved && sent;
         if (ended)
             this.info.error = undefined;
@@ -786,6 +878,9 @@ export class Channel {
         if (this.idle)
             clearTimeout(this.idle);
         this.idle = null;
+        if (this.outroTimer)
+            clearTimeout(this.outroTimer);
+        this.outroTimer = null;
         const said = lastLine(this.stderr);
         if (said && !this.info.error)
             this.info.error = said;

package/dist/outro.d.ts

@@ -0,0 +1,48 @@
+/** How long the outro plays after a show ends, before the channel closes. */
+export declare const OUTRO_MS: number;
+/** The clip's length; it loops. */
+export declare const OUTRO_SECONDS = 5;
+/** Bumped when the drawing changes, so an old clip on disk is drawn again. */
+export declare const OUTRO_VERSION = 1;
+export interface Rgba {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/** A canvas of straight RGBA bytes. */
+export declare class Bitmap {
+    readonly width: number;
+    readonly height: number;
+    readonly pixels: Uint8Array;
+    constructor(width: number, height: number);
+    fill(color: Rgba): void;
+    rect(x: number, y: number, w: number, h: number, color: Rgba): void;
+    private set;
+}
+/** Encode as a non-interlaced 8-bit RGBA PNG. */
+export declare function encodePng(bitmap: Bitmap): Buffer;
+export declare function textWidth(text: string, cell: number): number;
+export declare function drawText(bitmap: Bitmap, text: string, x: number, y: number, cell: number, color: Rgba): void;
+/** The picture: the mark above the words, on the plate. 1280x720. */
+export declare function drawOutro(width?: number, height?: number): Bitmap;
+/** The encode a channel copies an outro through: what a channel sends on the wire. */
+export declare const OUTRO_ENCODE: Record<"audio" | "video", string[]>;
+export interface OutroOptions {
+    ffmpeg: string[];
+    /** Where the clips are kept. */
+    dir: string;
+    onEvent?: (message: string) => void;
+}
+/**
+ * The clips, drawn on first use and kept. `clip(kind)` answers the path,
+ * or null when there is no ffmpeg to make one, in which case a channel
+ * that ends simply closes as it used to.
+ */
+export declare class Outro {
+    private readonly options;
+    private made;
+    constructor(options: OutroOptions);
+    clip(kind: "audio" | "video"): Promise<string | null>;
+    private make;
+}

package/dist/outro.js

@@ -0,0 +1,225 @@
+/**
+ * The outro: what a channel plays once its show is over.
+ *
+ * A live that ended used to start again from the top, for ever, because a
+ * source that finished cleanly was dialled like a source that dropped. Now
+ * it plays this: five seconds of "THIS LIVE STREAM HAS ENDED" on the
+ * plate with the mark, looped for an hour, so whoever joins late is told
+ * so by the picture and not by a blank panel. Then the channel closes.
+ *
+ * Drawn here, never committed as a file, the way the app's icons are:
+ * a bitmap, a 5x7 pixel face, and ffmpeg to make a clip of it. Encoded
+ * exactly as a channel is sent on the wire (H.264 and AAC for a picture,
+ * MP3 for sound alone) so the channel can copy it through without knowing
+ * how its own source was encoded. Made once per server and kept beside the
+ * keys; a missing or stale one is drawn again.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { deflateSync } from "node:zlib";
+/** How long the outro plays after a show ends, before the channel closes. */
+export const OUTRO_MS = 60 * 60 * 1000;
+/** The clip's length; it loops. */
+export const OUTRO_SECONDS = 5;
+/** Bumped when the drawing changes, so an old clip on disk is drawn again. */
+export const OUTRO_VERSION = 1;
+const BACKGROUND = { r: 8, g: 12, b: 9, a: 255 };
+const GREEN = { r: 74, g: 246, b: 137, a: 255 };
+const DIM = { r: 34, g: 122, b: 74, a: 255 };
+const MUTED = { r: 120, g: 150, b: 130, a: 255 };
+const BARS = [0.30, 0.55, 0.85, 0.62, 1.0, 0.72, 0.45, 0.25];
+/** A canvas of straight RGBA bytes. */
+export class Bitmap {
+    width;
+    height;
+    pixels;
+    constructor(width, height) {
+        this.width = width;
+        this.height = height;
+        this.pixels = new Uint8Array(width * height * 4);
+    }
+    fill(color) {
+        for (let i = 0; i < this.pixels.length; i += 4)
+            this.set(i, color);
+    }
+    rect(x, y, w, h, color) {
+        const x0 = Math.max(0, Math.round(x));
+        const y0 = Math.max(0, Math.round(y));
+        const x1 = Math.min(this.width, Math.round(x + w));
+        const y1 = Math.min(this.height, Math.round(y + h));
+        for (let py = y0; py < y1; py++) {
+            for (let px = x0; px < x1; px++)
+                this.set((py * this.width + px) * 4, color);
+        }
+    }
+    set(offset, { r, g, b, a }) {
+        this.pixels[offset] = r;
+        this.pixels[offset + 1] = g;
+        this.pixels[offset + 2] = b;
+        this.pixels[offset + 3] = a;
+    }
+}
+const CRC_TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let n = 0; n < 256; n++) {
+        let c = n;
+        for (let k = 0; k < 8; k++)
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        table[n] = c >>> 0;
+    }
+    return table;
+})();
+function crc32(bytes) {
+    let c = 0xffffffff;
+    for (const byte of bytes)
+        c = CRC_TABLE[(c ^ byte) & 0xff] ^ (c >>> 8);
+    return (c ^ 0xffffffff) >>> 0;
+}
+function chunk(type, data) {
+    const head = Buffer.alloc(8);
+    head.writeUInt32BE(data.length, 0);
+    head.write(type, 4, "ascii");
+    const body = Buffer.concat([head.subarray(4), Buffer.from(data)]);
+    const tail = Buffer.alloc(4);
+    tail.writeUInt32BE(crc32(body), 0);
+    return Buffer.concat([head.subarray(0, 4), body, tail]);
+}
+/** Encode as a non-interlaced 8-bit RGBA PNG. */
+export function encodePng(bitmap) {
+    const { width, height, pixels } = bitmap;
+    const stride = width * 4;
+    const raw = Buffer.alloc((stride + 1) * height);
+    for (let y = 0; y < height; y++) {
+        raw[y * (stride + 1)] = 0;
+        Buffer.from(pixels.subarray(y * stride, (y + 1) * stride)).copy(raw, y * (stride + 1) + 1);
+    }
+    const ihdr = Buffer.alloc(13);
+    ihdr.writeUInt32BE(width, 0);
+    ihdr.writeUInt32BE(height, 4);
+    ihdr[8] = 8;
+    ihdr[9] = 6;
+    return Buffer.concat([
+        Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),
+        chunk("IHDR", ihdr),
+        chunk("IDAT", deflateSync(raw, { level: 9 })),
+        chunk("IEND", new Uint8Array(0)),
+    ]);
+}
+/** A 5x7 pixel face: the letters the outro needs and nothing else. */
+const GLYPHS = {
+    A: [".XXX.", "X...X", "X...X", "XXXXX", "X...X", "X...X", "X...X"],
+    C: [".XXXX", "X....", "X....", "X....", "X....", "X....", ".XXXX"],
+    D: ["XXXX.", "X...X", "X...X", "X...X", "X...X", "X...X", "XXXX."],
+    E: ["XXXXX", "X....", "X....", "XXXX.", "X....", "X....", "XXXXX"],
+    H: ["X...X", "X...X", "X...X", "XXXXX", "X...X", "X...X", "X...X"],
+    I: ["XXXXX", "..X..", "..X..", "..X..", "..X..", "..X..", "XXXXX"],
+    L: ["X....", "X....", "X....", "X....", "X....", "X....", "XXXXX"],
+    M: ["X...X", "XX.XX", "X.X.X", "X.X.X", "X...X", "X...X", "X...X"],
+    N: ["X...X", "XX..X", "X.X.X", "X..XX", "X...X", "X...X", "X...X"],
+    O: [".XXX.", "X...X", "X...X", "X...X", "X...X", "X...X", ".XXX."],
+    P: ["XXXX.", "X...X", "X...X", "XXXX.", "X....", "X....", "X...."],
+    R: ["XXXX.", "X...X", "X...X", "XXXX.", "X.X..", "X..X.", "X...X"],
+    S: [".XXXX", "X....", "X....", ".XXX.", "....X", "....X", "XXXX."],
+    T: ["XXXXX", "..X..", "..X..", "..X..", "..X..", "..X..", "..X.."],
+    V: ["X...X", "X...X", "X...X", "X...X", "X...X", ".X.X.", "..X.."],
+    X: ["X...X", "X...X", ".X.X.", "..X..", ".X.X.", "X...X", "X...X"],
+    ".": [".....", ".....", ".....", ".....", ".....", "..XX.", "..XX."],
+};
+export function textWidth(text, cell) {
+    return text.length * 6 * cell - cell;
+}
+export function drawText(bitmap, text, x, y, cell, color) {
+    let at = x;
+    for (const letter of text) {
+        const rows = GLYPHS[letter];
+        if (rows) {
+            rows.forEach((row, r) => {
+                for (let c = 0; c < row.length; c++)
+                    if (row[c] === "X")
+                        bitmap.rect(at + c * cell, y + r * cell, cell, cell, color);
+            });
+        }
+        at += 6 * cell;
+    }
+}
+function drawBars(bitmap, left, bottom, width, tallest, scale) {
+    const slot = width / BARS.length;
+    const bar = slot * 0.62;
+    BARS.forEach((value, i) => {
+        const height = Math.max(2, tallest * value);
+        const x = left + i * slot + (slot - bar) / 2;
+        bitmap.rect(x, bottom - height, bar, height, GREEN);
+        const peak = Math.max(2, scale * 0.018);
+        bitmap.rect(x, bottom - height - peak * 2.4, bar, peak, DIM);
+    });
+    bitmap.rect(left, bottom, width, Math.max(2, scale * 0.028), DIM);
+}
+/** The picture: the mark above the words, on the plate. 1280x720. */
+export function drawOutro(width = 1280, height = 720) {
+    const bitmap = new Bitmap(width, height);
+    bitmap.fill(BACKGROUND);
+    const mark = height * 0.3;
+    drawBars(bitmap, (width - mark) / 2, height * 0.42, mark, mark - height * 0.02, mark * 1.8);
+    const line = "THIS LIVE STREAM HAS ENDED";
+    const cell = Math.floor(Math.min((width * 0.86) / (line.length * 6), height / 40));
+    drawText(bitmap, line, (width - textWidth(line, cell)) / 2, height * 0.56, cell, GREEN);
+    const small = Math.max(2, Math.floor(cell * 0.6));
+    const site = "NIXAMP.COM";
+    drawText(bitmap, site, (width - textWidth(site, small)) / 2, height * 0.56 + cell * 7 + small * 3, small, MUTED);
+    return bitmap;
+}
+/** The encode a channel copies an outro through: what a channel sends on the wire. */
+export const OUTRO_ENCODE = {
+    video: ["-c", "copy", "-f", "mp4", "-movflags", "frag_keyframe+empty_moov+default_base_moof"],
+    audio: ["-c", "copy", "-f", "mp3"],
+};
+/**
+ * The clips, drawn on first use and kept. `clip(kind)` answers the path,
+ * or null when there is no ffmpeg to make one, in which case a channel
+ * that ends simply closes as it used to.
+ */
+export class Outro {
+    options;
+    made = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    clip(kind) {
+        let pending = this.made.get(kind);
+        if (!pending) {
+            pending = Promise.resolve().then(() => this.make(kind)).catch(() => null);
+            this.made.set(kind, pending);
+            // A clip that could not be made is tried again next time, not remembered.
+            void pending.then((path) => { if (path === null)
+                this.made.delete(kind); });
+        }
+        return pending;
+    }
+    make(kind) {
+        mkdirSync(this.options.dir, { recursive: true });
+        const path = join(this.options.dir, kind === "video" ? `outro-v${OUTRO_VERSION}.mp4` : `outro-v${OUTRO_VERSION}.mp3`);
+        if (existsSync(path) && statSync(path).size > 1000)
+            return path;
+        const [command, ...prefix] = this.options.ffmpeg;
+        if (!command)
+            return null;
+        const args = ["-hide_banner", "-loglevel", "error", "-y"];
+        if (kind === "video") {
+            const picture = join(this.options.dir, `outro-v${OUTRO_VERSION}.png`);
+            writeFileSync(picture, encodePng(drawOutro()));
+            args.push("-loop", "1", "-framerate", "30", "-i", picture, "-f", "lavfi", "-i", "anullsrc=r=48000:cl=stereo", "-t", String(OUTRO_SECONDS), "-c:v", "libx264", "-preset", "veryfast", "-tune", "stillimage", "-pix_fmt", "yuv420p", "-r", "30", "-g", "30", "-keyint_min", "30", "-c:a", "aac", "-b:a", "64k", "-shortest", "-movflags", "+faststart", path);
+        }
+        else {
+            // Two soft notes, then quiet: something to hear on a channel with no picture.
+            args.push("-f", "lavfi", "-i", `aevalsrc=0.18*sin(2*PI*523.25*t)*exp(-2.5*t)+0.18*sin(2*PI*392*t)*exp(-2.5*max(t-0.7\\,0))*gte(t\\,0.7):s=44100:d=${OUTRO_SECONDS}`, "-c:a", "libmp3lame", "-b:a", "128k", path);
+        }
+        const run = spawnSync(command, [...prefix, ...args], { timeout: 60_000 });
+        if (run.error || run.status !== 0 || !existsSync(path)) {
+            this.options.onEvent?.(`  the outro could not be made${run.stderr ? `: ${run.stderr.toString("utf8").trim().split("\n").pop() ?? ""}` : ""}`);
+            return null;
+        }
+        this.options.onEvent?.(`  outro drawn: ${path}`);
+        return path;
+    }
+}

package/dist/rtmp-in.js

@@ -70,7 +70,12 @@ export class RtmpListeners {
         if (this.running.get(slot.port) !== child)
             return;
         this.running.delete(slot.port);
-        channel?.close();
+        // The publisher went: the outro plays for whoever is still there, and
+        // whoever joins in the next hour, before the channel closes.
+        if (channel?.finish)
+            channel.finish();
+        else
+            channel?.close();
         if (!this.stopped)
             this.arm(slot);
     }

package/dist/server.js

@@ -67,6 +67,7 @@ import { Rooms } from "./rooms.js";
 import { Trollbox, TrollboxError, fallbackHandle, roomFor } from "./trollbox.js";
 import { MAX_BYTES as SPEECH_BYTES, Speech, SpeechError, isWav, languageOf } from "./speech.js";
 import { Captions } from "./captions.js";
+import { Outro } from "./outro.js";
 import { Profiles, Voices, spokenLine, spokenVoiceFor } from "./voices.js";
 import { confirm, DEFAULT_DIRECTORY, Publisher } from "./publish.js";
 import { applyRemoteConfig, createPaywall, FREE_LISTENERS, paywallFromEnv, } from "./paywall.js";
@@ -2854,6 +2855,8 @@ export function createHandler(engine, options) {
                     // A picture of it, and a line about it, where there is one.
                     art: artOf(one),
                     about: one.about ?? "",
+                    // Over, with the outro playing: the page says so rather than "LIVE".
+                    ...(one.ended ? { ended: one.ended } : {}),
                 })),
                 // Anything re-streamed into this server is a live stream too, and was
                 // sitting in the middle of the playlist among the files -- which is
@@ -4726,8 +4729,14 @@ export async function serve(argv, version = "0.1.0") {
     });
     // The pictures of channels, taken once each and kept while the channel is on.
     const art = new ArtCache();
+    // What a channel plays once its show is over: drawn here, once, by the
+    // same ffmpeg that carries the channels. No ffmpeg, no outro, and a show
+    // that ends closes its channel as before.
+    const outro = new Outro({ ffmpeg: tools.ffmpeg, dir: join(stateDir(), "outro"), onEvent: (message) => console.log(message) });
     const channels = new Channels({
         ffmpeg: tools.ffmpeg,
+        ...(tools.carries ? { outro: (kind) => outro.clip(kind) } : {}),
+        onOutro: (info) => console.log(`  "${info.id}" has ended; the outro plays for an hour.`),
         onStart: (info) => console.log(`  ${info.name} is publishing to "${info.id}" (${info.format} over ${info.via}).`),
         onEnd: (info) => {
             console.log(`  "${info.id}" stopped.`);

package/package.json

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