# misakazentai/world-execute-me-dsh-pv architecture

> Architecture diagram of the GitHub repository misakazentai/world-execute-me-dsh-pv, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/misakazentai/world-execute-me-dsh-pv
- Repository: https://github.com/misakazentai/world-execute-me-dsh-pv

## Overview

This repository is the complete frame-rendering source for an unofficial TUI-style music video. The principal workflow is to provide the song, obtain timed lyrics, generate the replacement dancer and chat-window pages, capture those pages, then render and encode the film. The two visual halves are implemented separately: HTML/CSS-based dsh chat scenes and a PIL-based TUI world with song-timed scenes, dancer motion, transitions, and continuity. README statements establish the build stages; sampled source confirms selected rendering and scene relationships, but not every build command’s internal wiring.

Main entry points: [`build.py`](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/build.py) (Build orchestrator), [`film/pv_dsh_frontend_20260927`](https://github.com/misakazentai/world-execute-me-dsh-pv/tree/main/film/pv_dsh_frontend_20260927) (Chat scene batches), [`film/tui_pv_world_execute_20260926/full/engine.py`](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/engine.py) (Frame renderer), [`film/tui_pv_world_execute_20260926/continuity_full_v2/v2.py`](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/continuity_full_v2/v2.py) (Continuity director)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Build workflow"]
  node_build["Build orchestrator<br/>[build.py]"]
  node_movie["Rendered film"]
end

subgraph group_chat["Chat window"]
  node_dshscenes["Chat scene batches"]
  node_framehtml["Frame HTML<br/>[build_frame.py]"]
  node_segpage["Timed page scenes<br/>[seg_page.py]"]
  node_capture["Page screenshots<br/>[seg_shot.mjs]"]
end

subgraph group_world["TUI world"]
  node_tui["TUI primitives<br/>[tuikit.py]"]
  node_engine["Frame renderer<br/>[engine.py]"]
  node_continuity["Continuity director<br/>[v2.py]"]
  node_cuts["Scene transitions<br/>[cuts.py]"]
  node_kit["Layer composition<br/>[kit.py]"]
  node_choreo["Dancer choreography<br/>[choreo.py]"]
  node_dancerdraw["String dancer<br/>[dancer.py]"]
  node_motion["Motion vocabulary<br/>[motion.py]"]
  node_rig["Dancer rig<br/>[rig.py]"]
  node_music["Music timing<br/>[music.py]"]
end

subgraph group_assets["Timed assets"]
  node_song["Song audio"]
  node_lyrics["Lyrics timing<br/>[lyrics.py]"]
  node_dancer["Replacement dancer<br/>[placeholder_h3.py]"]
end

node_maker(("Video maker"))
node_lrclib["LRCLIB"]

node_maker -->|"provides"| node_song
node_maker -->|"runs"| node_build
node_build -->|"runs lyrics"| node_lyrics
node_lyrics -->|"downloads from"| node_lrclib
node_build -->|"generates dancer"| node_dancer
node_build -->|"builds pages"| node_dshscenes
node_dshscenes -->|"uses frame builder"| node_framehtml
node_dshscenes -->|"uses timed pages"| node_segpage
node_build -->|"screenshots pages"| node_capture
node_build -->|"renders film"| node_engine
node_engine -->|"uses drawing primitives"| node_tui
node_continuity -->|"configures cuts"| node_cuts
node_continuity -->|"sets up layers"| node_kit
node_kit -->|"composes frame"| node_engine
node_dancerdraw -->|"gets poses"| node_choreo
node_dancerdraw -->|"poses strings"| node_rig
node_choreo -->|"uses moves"| node_motion
node_build -->|"writes output"| node_movie

click node_build "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/build.py"
click node_lyrics "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/tools/lyrics.py"
click node_dancer "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/tools/placeholder_h3.py"
click node_dshscenes "https://github.com/misakazentai/world-execute-me-dsh-pv/tree/main/film/pv_dsh_frontend_20260927"
click node_framehtml "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/pv_dsh_frontend_20260927/build_frame.py"
click node_segpage "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/pv_dsh_frontend_20260927/seg_page.py"
click node_capture "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/pv_dsh_frontend_20260927/seg_shot.mjs"
click node_tui "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/tuikit.py"
click node_engine "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/engine.py"
click node_continuity "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/continuity_full_v2/v2.py"
click node_cuts "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/continuity_full_v2/cuts.py"
click node_kit "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/continuity_full_v2/kit.py"
click node_choreo "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/choreo.py"
click node_dancerdraw "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/dancer.py"
click node_motion "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/motion.py"
click node_rig "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/rig.py"
click node_music "https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/music.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_build,node_movie toneBlue
class node_dshscenes,node_framehtml,node_segpage,node_capture toneAmber
class node_tui,node_engine,node_continuity,node_cuts,node_kit,node_choreo,node_dancerdraw,node_motion,node_rig,node_music toneMint
class node_song,node_lyrics,node_dancer toneRose
class node_maker,node_lrclib toneIndigo
```

## Components

### Build workflow

- [Build orchestrator](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/build.py): `build.py`
- **Rendered film**

### Chat window

- [Chat scene batches](https://github.com/misakazentai/world-execute-me-dsh-pv/tree/main/film/pv_dsh_frontend_20260927): `film/pv_dsh_frontend_20260927`
- [Frame HTML](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/pv_dsh_frontend_20260927/build_frame.py): `film/pv_dsh_frontend_20260927/build_frame.py`
- [Timed page scenes](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/pv_dsh_frontend_20260927/seg_page.py): `film/pv_dsh_frontend_20260927/seg_page.py`
- [Page screenshots](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/pv_dsh_frontend_20260927/seg_shot.mjs): `film/pv_dsh_frontend_20260927/seg_shot.mjs`

### TUI world

- [TUI primitives](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/tuikit.py): `film/tui_pv_world_execute_20260926/tuikit.py`
- [Frame renderer](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/engine.py): `film/tui_pv_world_execute_20260926/full/engine.py`
- [Continuity director](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/continuity_full_v2/v2.py): `film/tui_pv_world_execute_20260926/continuity_full_v2/v2.py`
- [Scene transitions](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/continuity_full_v2/cuts.py): `film/tui_pv_world_execute_20260926/continuity_full_v2/cuts.py`
- [Layer composition](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/continuity_full_v2/kit.py): `film/tui_pv_world_execute_20260926/continuity_full_v2/kit.py`
- [Dancer choreography](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/choreo.py): `film/tui_pv_world_execute_20260926/full/choreo.py`
- [String dancer](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/dancer.py): `film/tui_pv_world_execute_20260926/full/dancer.py`
- [Motion vocabulary](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/motion.py): `film/tui_pv_world_execute_20260926/full/motion.py`
- [Dancer rig](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/rig.py): `film/tui_pv_world_execute_20260926/full/rig.py`
- [Music timing](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/film/tui_pv_world_execute_20260926/full/music.py): `film/tui_pv_world_execute_20260926/full/music.py`

### Timed assets

- **Song audio**
- [Lyrics timing](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/tools/lyrics.py): `tools/lyrics.py`
- [Replacement dancer](https://github.com/misakazentai/world-execute-me-dsh-pv/blob/main/tools/placeholder_h3.py): `tools/placeholder_h3.py`

### Other components

- **Video maker**
- **LRCLIB**

## Connections

- Video maker → Song audio: provides (evidence: `README.md`)
- Video maker → Build orchestrator: runs (evidence: `README.md`)
- Build orchestrator → Lyrics timing: runs lyrics (evidence: `README.md`)
- Lyrics timing → LRCLIB: downloads from (evidence: `README.md`)
- Build orchestrator → Replacement dancer: generates dancer (evidence: `README.md`)
- Build orchestrator → Chat scene batches: builds pages (evidence: `README.md`)
- Chat scene batches → Frame HTML: uses frame builder (evidence: `film/pv_dsh_frontend_20260927/batch_a1.py`)
- Chat scene batches → Timed page scenes: uses timed pages (evidence: `film/pv_dsh_frontend_20260927/batch_a1.py`)
- Build orchestrator → Page screenshots: screenshots pages (evidence: `README.md`)
- Build orchestrator → Frame renderer: renders film (evidence: `README.md`)
- Frame renderer → TUI primitives: uses drawing primitives (evidence: `film/tui_pv_world_execute_20260926/full/engine.py`)
- Continuity director → Scene transitions: configures cuts (evidence: `film/tui_pv_world_execute_20260926/continuity_full_v2/v2.py`)
- Continuity director → Layer composition: sets up layers (evidence: `film/tui_pv_world_execute_20260926/continuity_full_v2/v2.py`)
- Layer composition → Frame renderer: composes frame (evidence: `film/tui_pv_world_execute_20260926/continuity_full_v2/kit.py`)
- String dancer → Dancer choreography: gets poses (evidence: `film/tui_pv_world_execute_20260926/full/dancer.py`)
- String dancer → Dancer rig: poses strings (evidence: `film/tui_pv_world_execute_20260926/full/dancer.py`)
- Dancer choreography → Motion vocabulary: uses moves (evidence: `film/tui_pv_world_execute_20260926/full/choreo.py`)
- Build orchestrator → Rendered film: writes output (evidence: `README.md`)
