Entertainment Harness logo

// terragohan.com

Entertainment Harness

A local-first entertainment system.

Track manga and books from real sources, then turn chapters into narrated recap videos with local vision models — your library and artifacts never leave your machine unless you opt in.

Get it on GitHub Read the docs

v0.1.0 · macOS, Apple silicon · runs from the repo

What it does

Manga recaps

Everything is extensible — recap models, voices, and video styles are swappable providers, with defaults of local Ollama vision models, Kokoro TTS narration, and Ken Burns motion over the real pages.

Manga → animein development

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.

Custom sourcesin development

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

Screenshots

Library view
Work detail
Video player

Get started

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 video

The 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 dir

The default model backend is Ollama; remote backends like OpenRouter are configured in ~/.local/share/entertainment-harness/config.toml. Full details in the docs.

License

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.