Skip to content

Open-source AI podcast clipper. Generate vertical clips with face tracking and burned-in captions. CLI, MCP server, web app.

Address follow-up PR review feedback

Teethat Kamsai3ea775582637
diff --git a/backend/cli.py b/backend/cli.py
index 3205496..442953a 100644
--- a/backend/cli.py
+++ b/backend/cli.py
@@ -594,7 +594,8 @@ def cmd_process(args):
result = cached
print(f" {len(segments)} segments, {len(words)} words")
else:
- engine_label = "AssemblyAI" if os.environ.get("PODCLI_ENGINE", "").strip().lower() in ("assemblyai", "assembly-ai", "aai") else "Whisper"
+ from services.engines import is_assemblyai_engine
+ engine_label = "AssemblyAI" if is_assemblyai_engine(os.environ.get("PODCLI_ENGINE", "")) else "Whisper"
print(f" [1/4] Transcribing with {engine_label}...")
_ensure_ssl_certs()
import warnings
diff --git a/backend/clip_studio.py b/backend/clip_studio.py
index 731de78..33c6a1b 100644
--- a/backend/clip_studio.py
+++ b/backend/clip_studio.py
@@ -84,9 +84,9 @@ def _probe_duration(path: str) -> float:
def _transcribe(video: str, language: str | None, engine: str | None):
"""Transcribe (cached) and return the word list."""
+ from services.engines import is_assemblyai_engine
from services.transcription import transcribe_file
- selected = (engine or os.environ.get("PODCLI_ENGINE", "")).strip().lower()
- label = "AssemblyAI" if selected in ("assemblyai", "assembly-ai", "aai") else "Whisper"
+ label = "AssemblyAI" if is_assemblyai_engine(engine or os.environ.get("PODCLI_ENGINE", "")) else "Whisper"
print(f" [transcribe] running {label}...", flush=True)
res = transcribe_file(
file_path=video, model_size="base", engine=engine, language=language,
diff --git a/backend/services/engines.py b/backend/services/engines.py
new file mode 100644
index 0000000..1fd49b8
--- /dev/null
+++ b/backend/services/engines.py
@@ -0,0 +1,11 @@
+def normalize_engine(name: str | None) -> str:
+ value = (name or "whisper-py").strip().lower()
+ if value in ("whispercpp", "whisper-cpp", "whisper.cpp", "cpp"):
+ return "whispercpp"
+ if value in ("assemblyai", "assembly-ai", "aai"):
+ return "assemblyai"
+ return "whisper-py"
+
+
+def is_assemblyai_engine(name: str | None) -> bool:
+ return normalize_engine(name) == "assemblyai"
diff --git a/backend/services/transcript_packer.py b/backend/services/transcript_packer.py
index 38ac584..82777c5 100644
--- a/backend/services/transcript_packer.py
+++ b/backend/services/transcript_packer.py
@@ -19,6 +19,7 @@ import sys
from typing import Any, Optional
from config.paths import paths
+from services.engines import normalize_engine
def _transcripts_cache_dir() -> str:
return paths["transcripts"]
@@ -72,10 +73,10 @@ def _engine_cache_suffix() -> str:
def engine_cache_suffix(engine: str | None) -> str:
- engine = (engine or "whisper-py").strip().lower()
- if engine in ("whispercpp", "whisper-cpp", "whisper.cpp", "cpp"):
+ engine = normalize_engine(engine)
+ if engine == "whispercpp":
return "-whispercpp"
- if engine in ("assemblyai", "assembly-ai", "aai"):
+ if engine == "assemblyai":
return "-assemblyai"
return ""
diff --git a/backend/services/transcription.py b/backend/services/transcription.py
index cd962ac..9b34476 100644
--- a/backend/services/transcription.py
+++ b/backend/services/transcription.py
@@ -19,6 +19,8 @@ import urllib.parse
import urllib.request
from typing import Optional, Callable
+from services.engines import is_assemblyai_engine, normalize_engine
+
def _managed_home() -> str:
h = os.environ.get("PODCLI_HOME")
@@ -463,10 +465,10 @@ def transcribe_file(
if not os.path.exists(file_path):
raise FileNotFoundError(f"File not found: {file_path}")
- requested = (engine if engine is not None else os.environ.get("PODCLI_ENGINE", "")).strip().lower()
- engine = requested or "whisper-py"
- use_cpp = engine in ("whispercpp", "whisper-cpp", "whisper.cpp", "cpp")
- use_assemblyai = engine in ("assemblyai", "assembly-ai", "aai")
+ requested = engine if engine is not None else os.environ.get("PODCLI_ENGINE", "")
+ engine = normalize_engine(requested)
+ use_cpp = engine == "whispercpp"
+ use_assemblyai = is_assemblyai_engine(engine)
if use_assemblyai:
base = _transcribe_with_assemblyai(
diff --git a/cli/main.go b/cli/main.go
index 6e41bb8..6521283 100644
--- a/cli/main.go
+++ b/cli/main.go
@@ -3,6 +3,7 @@
package main
import (
+ "bytes"
"fmt"
"os"
"os/exec"
@@ -437,10 +438,15 @@ if ($kept.Count -eq $parts.Count) { exit 2 }
$key.SetValue('Path', ($kept -join ';'), $kind)`
cmd := exec.Command("powershell", "-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", ps)
cmd.Env = append(os.Environ(), "PODCLI_REMOVE_PATH="+remove)
+ var stderr bytes.Buffer
+ cmd.Stderr = &stderr
if err := cmd.Run(); err != nil {
if exit, ok := err.(*exec.ExitError); ok && exit.ExitCode() == 2 {
return false, nil
}
+ if detail := strings.TrimSpace(stderr.String()); detail != "" {
+ return false, fmt.Errorf("%w: %s", err, detail)
+ }
return false, err
}
return true, nil
diff --git a/src/handlers/transcribe.handler.ts b/src/handlers/transcribe.handler.ts
index 1d05949..e15f789 100644
--- a/src/handlers/transcribe.handler.ts
+++ b/src/handlers/transcribe.handler.ts
@@ -113,10 +113,11 @@ export async function handleTranscribe(input: TranscribeInput): Promise<string>
throw new Error("Transcription returned no data");
}
const data = result.data;
+ const resolvedEngine = data.engine;
// Cache the raw result
- await cache.set(filePath, data, engine);
- const packed = await cache.getPackedMarkdown(filePath, data.engine ?? engine);
+ await cache.set(filePath, data, resolvedEngine);
+ const packed = await cache.getPackedMarkdown(filePath, resolvedEngine);
return JSON.stringify({ cached: false, packed_ready: !!packed, ...formatResult(data) });
}