Open-source AI podcast clipper. Generate vertical clips with face tracking and burned-in captions. CLI, MCP server, web app.
Python ai-toolsauto-captionscaptionscliffmpegmcpmcp-serveropusclip-alternativepodcast-clipspodcastsshortform-videovertical-videowhisper
import { describe, it, expect, beforeAll, afterAll } from "vitest";
import { mkdirSync, mkdtempSync, rmSync } from "fs";
import { tmpdir } from "os";
import { join } from "path";
import { stubPythonBackend } from "../test-support/stub-python-backend.js";
// A bare set_video from MCP (videoPath with no transcript in the same
// request) clears the server's transcript/suggestions/selections, since
// they describe a recording that's no longer loaded. But the SSE broadcast
// only echoed back whatever fields the request body itself carried. A
// request that only sent videoPath never told the studio that transcript
// and suggestions were cleared too, so the studio's in-memory copies stayed
// stale and a later sync from the studio wrote them right back onto the
// server.
const tmp = mkdtempSync(join(tmpdir(), "podcli-video-change-broadcast-"));
const savedEnv = {
PODCLI_HOME: process.env.PODCLI_HOME,
PODCLI_DATA: process.env.PODCLI_DATA,
PODCLI_PORT: process.env.PODCLI_PORT,
};
const PORT = 18429;
async function waitForServer(): Promise<void> {
for (let i = 0; i < 50; i++) {
try {
const res = await fetch(`http://127.0.0.1:${PORT}/api/ui-state`);
if (res.ok) return;
} catch {
// not up yet
}
await new Promise((r) => setTimeout(r, 100));
}
throw new Error("web server never came up");
}
beforeAll(async () => {
process.env.PODCLI_HOME = join(tmp, "home");
process.env.PODCLI_DATA = join(tmp, "data");
process.env.PODCLI_PORT = String(PORT);
mkdirSync(process.env.PODCLI_HOME, { recursive: true });
// The web server spawns the Python backend on startup (manage_config status
// check) and per request. Stub it so the test never depends on a real backend.
await stubPythonBackend();
await import("./web-server.js");
await waitForServer();
}, 20_000);
afterAll(() => {
for (const [key, value] of Object.entries(savedEnv)) {
if (value === undefined) delete process.env[key];
else process.env[key] = value;
}
rmSync(tmp, { recursive: true, force: true });
});
/** Collects every "event: state-sync" payload broadcast while `during` runs. */
interface StateSyncEvent {
videoPath?: string;
transcript?: object | null;
suggestions?: object[];
}
async function captureStateSyncEvents(during: () => Promise<void>): Promise<StateSyncEvent[]> {
const res = await fetch(`http://127.0.0.1:${PORT}/api/events`);
const reader = res.body!.getReader();
const decoder = new TextDecoder();
let buffer = "";
const events: StateSyncEvent[] = [];
const pump = async () => {
for (;;) {
const { value, done } = await reader.read();
if (done) return;
buffer += decoder.decode(value, { stream: true });
let idx;
while ((idx = buffer.indexOf("\n\n")) !== -1) {
const chunk = buffer.slice(0, idx);
buffer = buffer.slice(idx + 2);
const eventLine = chunk.split("\n").find((l) => l.startsWith("event: "));
const dataLine = chunk.split("\n").find((l) => l.startsWith("data: "));
if (eventLine?.slice(7) === "state-sync" && dataLine) {
events.push(JSON.parse(dataLine.slice(6)));
}
}
}
};
const pumpPromise = pump();
await during();
await new Promise((r) => setTimeout(r, 200)); // let the broadcast land
await reader.cancel();
await pumpPromise.catch(() => {});
return events;
}
describe("POST /api/ui-state video change broadcast", () => {
it("broadcasts the cleared transcript and suggestions, not just videoPath", async () => {
const videoA = join(tmp, "episode-a.mp4");
const videoB = join(tmp, "episode-b.mp4");
// Seed a session on video A with a transcript and a suggestion.
await fetch(`http://127.0.0.1:${PORT}/api/ui-state`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
videoPath: videoA,
transcript: { words: [{ word: "hi", start: 0, end: 1 }] },
suggestions: [
{ clip_id: "c1", title: "a moment", start_second: 0, end_second: 5, duration: 5, reasoning: "", preview_text: "" },
],
}),
});
const events = await captureStateSyncEvents(async () => {
// A bare set_video from MCP: videoPath changes, no transcript in the
// same request.
await fetch(`http://127.0.0.1:${PORT}/api/ui-state`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ videoPath: videoB }),
});
});
expect(events.length).toBeGreaterThan(0);
const last = events[events.length - 1];
expect(last.videoPath).toBe(videoB);
expect(last.transcript).toBeNull();
expect(last.suggestions).toEqual([]);
});
});