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, beforeEach } from "vitest";
import { mkdtempSync, writeFileSync, rmSync, mkdirSync } from "fs";
import { tmpdir } from "os";
import { join } from "path";
// Isolate PODCLI_HOME before the module (and its paths import) are evaluated.
const tmp = mkdtempSync(join(tmpdir(), "podcli-test-"));
process.env.PODCLI_HOME = tmp;
process.env.PODCLI_DATA = tmp;
const { ClipsHistory } = await import("./clips-history.js");
type NewClip = Parameters<InstanceType<typeof ClipsHistory>["record"]>[0];
type ClipFields = Pick<
NewClip,
"source_video" | "output_path" | "start_second" | "end_second" | "caption_style" | "crop_strategy" | "title"
> &
Partial<NewClip>;
/** A history entry with the fields these tests do not care about filled in. */
const clip = (fields: ClipFields): NewClip => ({
duration: fields.end_second - fields.start_second,
file_size_mb: 1,
format: "vertical",
...fields,
});
function makeFakeOutput(name: string): string {
const p = join(tmp, name);
writeFileSync(p, "stub");
return p;
}
describe("ClipsHistory", () => {
let history: InstanceType<typeof ClipsHistory>;
beforeEach(() => {
// Reset history dir for each test
rmSync(join(tmp, "history"), { recursive: true, force: true });
mkdirSync(join(tmp, "history"), { recursive: true });
history = new ClipsHistory();
});
it("records and lists clips", async () => {
await history.record(clip({
source_video: "/videos/show.mp4",
output_path: makeFakeOutput("a.mp4"),
start_second: 10,
end_second: 40,
caption_style: "karaoke",
crop_strategy: "smart",
title: "hook A",
}));
const list = await history.list();
expect(list).toHaveLength(1);
expect(list[0].title).toBe("hook A");
});
it("findDuplicate matches within ±2s tolerance", async () => {
const output = makeFakeOutput("b.mp4");
await history.record(clip({
source_video: "/videos/show.mp4",
output_path: output,
start_second: 10,
end_second: 40,
caption_style: "karaoke",
crop_strategy: "smart",
title: "original",
}));
const dup = await history.findDuplicate("/videos/show.mp4", 11, 41, "karaoke", "smart");
expect(dup).not.toBeNull();
expect(dup?.title).toBe("original");
const miss = await history.findDuplicate("/videos/show.mp4", 15, 45, "karaoke", "smart");
expect(miss).toBeNull();
});
it("findDuplicate ignores entries whose output file is missing", async () => {
const output = makeFakeOutput("c.mp4");
await history.record(clip({
source_video: "/videos/show.mp4",
output_path: output,
start_second: 100,
end_second: 130,
caption_style: "karaoke",
crop_strategy: "smart",
title: "ghost",
}));
rmSync(output);
const dup = await history.findDuplicate("/videos/show.mp4", 100, 130, "karaoke", "smart");
expect(dup).toBeNull();
});
it("minedYouTubeVideoIds reads the id out of the yt-dlp output template", async () => {
await history.record(clip({
source_video: "/videos/Some Episode Title [aBc123_XYZ].mp4",
output_path: makeFakeOutput("d.mp4"),
start_second: 0,
end_second: 10,
caption_style: "karaoke",
crop_strategy: "smart",
title: "clip",
}));
const ids = await history.minedYouTubeVideoIds();
expect(ids.has("aBc123_XYZ")).toBe(true);
});
it("minedYouTubeVideoIds is empty when no source_video carries a bracketed id", async () => {
await history.record(clip({
source_video: "/videos/local-recording.mp4",
output_path: makeFakeOutput("e.mp4"),
start_second: 0,
end_second: 10,
caption_style: "karaoke",
crop_strategy: "smart",
title: "clip",
}));
const ids = await history.minedYouTubeVideoIds();
expect(ids.size).toBe(0);
});
it("recordBatchResults skips failed/output-less rows and applies defaults", async () => {
const ok = makeFakeOutput("batch-ok.mp4");
const recorded = await history.recordBatchResults(
[
{ status: "success", output_path: ok, start_second: 5, end_second: 20, title: "kept" },
{ status: "error", error: "boom" },
{ status: "success", title: "no output" },
],
{ sourceVideo: "/videos/show.mp4", defaultCaptionStyle: "hormozi", defaultCropStrategy: "speaker" },
);
expect(recorded).toHaveLength(1);
expect(recorded[0].title).toBe("kept");
expect(recorded[0].caption_style).toBe("hormozi");
expect(recorded[0].crop_strategy).toBe("speaker");
const list = await history.list();
expect(list).toHaveLength(1);
});
it("recordBatchResults resolves content_type and transcript_slice per row", async () => {
const ok = makeFakeOutput("batch-ct.mp4");
const recorded = await history.recordBatchResults(
[{ status: "success", output_path: ok, start_second: 0, end_second: 10, title: "ct" }],
{
sourceVideo: "/videos/show.mp4",
transcriptWords: [
{ word: "hello", start: 1, end: 2, confidence: 1 },
{ word: "world", start: 3, end: 4, confidence: 1 },
{ word: "later", start: 99, end: 100, confidence: 1 },
],
contentTypeFor: (s, e) => (s === 0 && e === 10 ? "hook" : undefined),
},
);
expect(recorded[0].content_type).toBe("hook");
expect(recorded[0].transcript_slice).toBe("hello world");
});
it("recordBatchResults tolerates undefined results", async () => {
const recorded = await history.recordBatchResults(undefined, { sourceVideo: "/videos/show.mp4" });
expect(recorded).toEqual([]);
});
it("serializes concurrent records without losing entries", async () => {
await Promise.all(
Array.from({ length: 25 }, (_, i) =>
history.record(clip({
source_video: "/videos/show.mp4",
output_path: makeFakeOutput(`c-${i}.mp4`),
start_second: i,
end_second: i + 5,
caption_style: "karaoke",
crop_strategy: "smart",
title: `clip ${i}`,
})),
),
);
const list = await history.list(100);
expect(list).toHaveLength(25);
expect(new Set(list.map((c) => c.id)).size).toBe(25);
});
it("findById and update require an exact id (no prefix match)", async () => {
const rec = await history.record(clip({
source_video: "/videos/show.mp4",
output_path: makeFakeOutput("exact.mp4"),
start_second: 0,
end_second: 10,
caption_style: "karaoke",
crop_strategy: "smart",
title: "exact",
}));
expect(await history.findById(rec.id)).toBeDefined();
expect(await history.findById(rec.id.slice(0, 8))).toBeUndefined();
expect(await history.findById("")).toBeUndefined();
expect(await history.update("", { title: "x" })).toBeNull();
expect(await history.update(rec.id.slice(0, 8), { title: "x" })).toBeNull();
const ok = await history.update(rec.id, { title: "renamed" });
expect(ok?.title).toBe("renamed");
});
it("resolveId accepts a full id or unambiguous ≥4-char prefix, rejects short/empty", async () => {
const rec = await history.record(clip({
source_video: "/videos/show.mp4",
output_path: makeFakeOutput("resolve.mp4"),
start_second: 0,
end_second: 10,
caption_style: "karaoke",
crop_strategy: "smart",
title: "resolve",
}));
expect(await history.resolveId(rec.id)).toBe(rec.id);
expect(await history.resolveId(rec.id.slice(0, 8))).toBe(rec.id);
expect(await history.resolveId("")).toBeNull();
expect(await history.resolveId(rec.id.slice(0, 2))).toBeNull();
});
it("findDuplicate matches by basename, not full path", async () => {
const output = makeFakeOutput("d.mp4");
await history.record(clip({
source_video: "/absolute/path/one/show.mp4",
output_path: output,
start_second: 0,
end_second: 30,
caption_style: "karaoke",
crop_strategy: "smart",
title: "basename test",
}));
const dup = await history.findDuplicate("/different/path/show.mp4", 0, 30, "karaoke", "smart");
expect(dup).not.toBeNull();
});
});