explaingit

jaxxchen003/book-video-factory

Analysis updated 2026-05-18

58PythonAudience · developerLicenseSetup · moderate

TLDR

A rights-aware Codex skill that turns a Chinese book into a short review video, with human approvals and cost tracking at every step.

Mindmap

mindmap
  root((repo))
    What it does
      Rights-aware video workflow
      Chinese book reviews
      Human approval gates
    Tech stack
      Python
      Codex skill
      FFmpeg rendering
      Gemini API
    Use cases
      Bilingual editorial videos
      VOX-style explainer videos
      Auditable cost tracking
    Audience
      Content creators
      Codex users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Bootstrap a rights-aware Chinese book-review video project inside Codex.

USE CASE 2

Generate VOX-style short videos with Gemini API or Google Flow while tracking approvals and costs.

USE CASE 3

Produce a Bilingual Editorial Book Video with authorized covers, stills, and captions.

USE CASE 4

Keep an auditable record of evidence, approvals, and provider costs for every video.

What is it built with?

PythonCodexFFmpegGemini APIGoogle Flow

How does it compare?

jaxxchen003/book-video-factoryamazinghorseli/rednote-insightelacuesta/scrapy-pyppeteer
Stars585858
LanguagePythonPythonPython
Last pushed2021-02-26
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/53/5
Audiencedeveloperpm founderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

VOX-style generation needs a Google GEMINI_API_KEY or an eligible Google Flow account.

In plain English

Book Video Factory is an installable skill for Codex that helps you produce short review videos for Chinese books, while keeping a careful record of rights, evidence, and approvals along the way. It supports two different video styles: the original Bilingual Editorial Book Video, and a newer VOX-style Book Video that leans on voice narration paired with short visual scenes. Importantly, the repository itself does not include any book content, covers, music, sound effects, voice samples, or credentials. Everything shown in the examples folder is a finished showcase video, not raw material bundled with the tool, and those demo videos are not covered by the project's MIT license, since books, music, and other elements belong to their original rights holders. You install the skill through a command line tool called npx skills, then open a new task in Codex and ask it to bootstrap a project for a specific book title and author. From there the skill sets up a consistent folder structure, a bilingual script template, and links each line of the script back to its supporting claims and source material. Every decision along the way, including technical checks, story review, background music rights, and final publication, has to be approved separately by a human, and nothing gets marked as ready to release unless the file hashes and the recorded approvals actually match up. Costs from any AI providers used are logged honestly, without inventing numbers. For the newer VOX-style videos, there are two ways to generate visuals: through Google's Gemini API for programmatic, repeatable generation, or through Google Flow's manual creative interface for a human to adjust each scene by hand. Either way, the tool records the prompt, the model used, input and output file hashes, and who approved each step, and any AI-generated audio gets removed unless it has its own separate approval. The overall workflow moves through locking down an approved script, generating narration and timing, approving the visual concept and layout in stages, generating the actual clips, and finally combining picture, narration, captions, music, and branding into a finished video that passes a technical check before publication.

Copy-paste prompts

Prompt 1
Use $book-video-factory to bootstrap a workspace and create my first book-video project for a given title and author.
Prompt 2
Explain the difference between the Bilingual Editorial and VOX-style book video profiles.
Prompt 3
Walk me through the gemini-api and google-flow generation lanes in book-video-factory.
Prompt 4
Show me how the fail-closed release approval and cost ledger system works in this skill.

Frequently asked questions

What is book-video-factory?

A rights-aware Codex skill that turns a Chinese book into a short review video, with human approvals and cost tracking at every step.

What language is book-video-factory written in?

Mainly Python. The stack also includes Python, Codex, FFmpeg.

How hard is book-video-factory to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is book-video-factory for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.