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 { join, dirname, resolve, isAbsolute } from "path";
import { fileURLToPath } from "url";
import { existsSync, readFileSync } from "fs";
const __dirname = dirname(fileURLToPath(import.meta.url));
const projectRoot = resolve(__dirname, "..", "..");
const homeMarker = join(projectRoot, ".podcli-home");
const dataDir = resolve(process.env.PODCLI_DATA || join(projectRoot, "data"));
const outputDir = resolve(process.env.PODCLI_OUTPUT || join(dataDir, "output"));
function resolveHome(): string {
if (process.env.PODCLI_HOME) {
return resolve(process.env.PODCLI_HOME);
}
if (existsSync(homeMarker)) {
try {
const marker = readFileSync(homeMarker, "utf-8").trim();
if (marker) {
return isAbsolute(marker) ? resolve(marker) : resolve(projectRoot, marker);
}
} catch {
// Unreadable marker: fall through to the default home.
}
}
return resolve(projectRoot, ".podcli");
}
const home = resolveHome();
// Hermetic installs run from a bundled runtime where the backend lives outside
// projectRoot; the launcher points PODCLI_BACKEND at it.
function resolveBackendDir(): string {
if (process.env.PODCLI_BACKEND) {
return resolve(process.env.PODCLI_BACKEND);
}
const sourceBackend = join(projectRoot, "backend");
if (existsSync(join(sourceBackend, "cli.py"))) {
return sourceBackend;
}
const runtimeBackend = join(projectRoot, "runtime", "backend");
if (existsSync(join(runtimeBackend, "cli.py"))) {
return runtimeBackend;
}
return sourceBackend;
}
const backendDir = resolveBackendDir();
function detectPython(): string {
if (process.env.PYTHON_PATH) return process.env.PYTHON_PATH;
const isWindows = process.platform === "win32";
const venvPython = join(
projectRoot,
"venv",
isWindows ? "Scripts" : "bin",
isWindows ? "python.exe" : "python3"
);
if (existsSync(venvPython)) return venvPython;
return isWindows ? "python" : "python3";
}
export const paths = {
home,
projectRoot,
backendDir,
homeMarker,
dataDir,
cache: join(dataDir, "cache"),
transcripts: join(dataDir, "cache", "transcripts"),
packed: join(home, "packed"),
working: join(dataDir, "working"),
output: outputDir,
logs: join(dataDir, "logs"),
assets: join(home, "assets"),
assetsRegistry: join(home, "assets", "registry.json"),
history: join(home, "history"),
clipsHistory: join(home, "history", "clips.json"),
knowledge: join(home, "knowledge"),
uiState: join(home, "ui-state.json"),
episodeDecisions: join(home, "episode-decisions.json"),
corrections: join(home, "corrections.json"),
thumbnailConfig: join(home, "thumbnail-config.json"),
integrations: join(home, "integrations.json"),
// Mirrors PODCLI_ENV_FILE from the Go launcher and backend/services/env_settings.py.
// Reading it from process.cwd() instead is how HF_TOKEN went missing and speaker
// detection silently stayed off.
envFile: process.env.PODCLI_ENV_FILE || join(home, ".env"),
pythonBackend: join(backendDir, "main.py"),
pythonPath: detectPython(),
ffmpegPath: process.env.FFMPEG_PATH || "ffmpeg",
ffprobePath: process.env.FFPROBE_PATH || "ffprobe",
};
// Python falls back to the host locale encoding, which is cp1252 on most Windows
// installs. Titles carry em dashes and smart quotes, and U+201D encodes byte 0x9D,
// which cp1252 leaves undefined: reading it raises UnicodeDecodeError. Every spawn
// of the Python backend goes through here so no call site can forget.
export function pythonEnv(extra: Record<string, string> = {}): NodeJS.ProcessEnv {
return {
...process.env,
PYTHONUNBUFFERED: "1",
PYTHONIOENCODING: "utf-8",
PYTHONUTF8: "1",
...extra,
};
}