How thiet1910-bam/2d-illustrated-history works
Ziro-History-Studio-v3 is a toolkit for producing long-form illustrated history videos. Episode materials are organized into adaptive clusters with narration timing and lip-sync data; audio is mixed, scenes are rendered to video, outputs can be visually checked, and cluster videos can be concatenated into a master. The repository also provides reusable character, typography, and map drawing tools plus Wikimedia image discovery. Several engine connections are documented in the README, but unsampled renderer and episode wiring is not inferred here.
Main entry points: helpers.js Drawing Helpers · mix_audio.py Audio Mixer · episodes Cluster Videos · maps.js Map Drawing Tools
Components 17
Episode Production
- Episode Materials
episodes - Cluster Scanner
engine/scan_clusters.py - Wikimedia Image Finder
engine/fetch_wikimedia.py
Media Processing
- Audio Mixer
engine/mix_audio.py - BGM and SFX
shared - Canvas Video Renderer
engine/render.js
Visual Toolkit
- Brand Host
shared/ziro_kit/brand_host.js - Skit Character Rig
shared/ziro_kit/skit_rig.js - Kinetic Typography
shared/ziro_kit/kinetic_type.js - Map Drawing Tools
shared/ziro_kit/maps.js - Drawing Helpers
shared/ziro_kit/helpers.js - Satellite Map
shared/maps
Review and Delivery
- Visual QA Sheet
engine/build_qa_sheet.py - Cluster Videos
episodes - Master Concatenator
engine/concat_master.py - Master Video
episodes
Other components
- Episode Creator
Connections 15
- Episode Creator → Episode Materials: creates
README.md - Episode Materials → Cluster Scanner: provides episode
README.md - Cluster Scanner → Audio Mixer: prepares cluster audio
- Audio Mixer → BGM and SFX: uses audio
engine/mix_audio.py - Audio Mixer → Canvas Video Renderer: mixes for rendering
- Wikimedia Image Finder → Satellite Map: complements maps
- Map Drawing Tools → Satellite Map: draws from
README.md - Brand Host → Drawing Helpers: uses helpers
shared/ziro_kit/brand_host.js - Skit Character Rig → Drawing Helpers: uses helpers
shared/ziro_kit/skit_rig.js - Kinetic Typography → Drawing Helpers: uses helpers
shared/ziro_kit/kinetic_type.js - Map Drawing Tools → Drawing Helpers: uses helpers
shared/ziro_kit/maps.js - Canvas Video Renderer → Cluster Videos: renders MP4
README.md - Cluster Videos → Visual QA Sheet: checks rendered output
README.md - Cluster Videos → Master Concatenator: provides clusters
README.md - Master Concatenator → Master Video: concatenates
README.md