Manga recaps

Chapter recaps with rolling story context, Kokoro TTS narration, and Ken Burns motion over the real pages.

Chapter recaps with rolling story context, Kokoro TTS narration, and Ken Burns motion over the real pages.

A guided storyboard pipeline: keyframes generated from your panels by the video model of your choice (Runway by default), assembled into short 16:9 clips.

A plugin API for content sources beyond the built-in MangaDex and Weeb Central catalogs — point the harness at your own endpoints.

Requires Python ≥ 3.13 and ffmpeg. Everything runs from a clone of the repo; the desktop app is macOS-only.

git clone https://github.com/terragohan/entertainment-harness

cd entertainment-harness

uv sync

uv run eh add "One Piece" # search a source, add the series

uv run eh sync # fetch its chapter list

uv run eh recap "One Piece" --video --chapters 1

uv run eh play "One Piece" # watch the generated recap videoThe desktop app (macOS, Apple silicon) runs from the same checkout — it also needs Bun:

cd ui

bun install

bun run dev # builds and launches the app against your data dirThe default model backend is Ollama; remote

backends like OpenRouter are configured in

~/.local/share/entertainment-harness/config.toml.

Full details in the docs.

Source-available under GPL-3.0 with the Commons Clause: free to use, study, modify, and redistribute with attribution; selling the software or offering it as a paid hosted service requires the licensor's permission. Because of that clause this is intentionally not OSI "open source".

Videos you generate are yours — but the source manga/books are copyrighted by their authors and publishers, so treat recap videos as personal media. If you share them, crediting both the source work (title + author) and the tool is required, and every render ends with a credits card carrying that attribution — see SHARING.md before uploading anything to sharing platforms.