# nyankomintsu/world-execute-me-lyric-mv architecture

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

- Interactive diagram: https://gitdiagram.com/nyankomintsu/world-execute-me-lyric-mv
- Repository: https://github.com/nyankomintsu/world-execute-me-lyric-mv

## Overview

This repository is a browser-based lyric-video renderer: the film is drawn as a deterministic function of song time, previewed in a browser, and exported frame by frame. Its main workflow is user-provided lyrics and audio → timed scenes → rendered frames → video. The README documents Canvas 2D/WebGL2 rendering and ffmpeg export; sampled files show the engine and scene registry, but not the full exporter or all scene implementations, so some capability links are documented rather than source-verified.

Main entry points: [`src/engine/engine.js`](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/engine.js) (Frame engine), [`export/export.mjs`](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/export/export.mjs) (Frame exporter), [`src/scenes/index.js`](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/scenes/index.js) (Scene registry), [`src/scenes`](https://github.com/nyankomintsu/world-execute-me-lyric-mv/tree/main/src/scenes) (Song sections)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Input and export"]
  node_lyrics["Lyric matching<br/>[fill_lyrics.mjs]"]
  node_preview["Browser preview<br/>[main.js]"]
  node_exporter["Frame exporter<br/>[export.mjs]"]
  node_server["Local server<br/>[server.mjs]"]
  node_frames["Frame transport<br/>[wsframes.mjs]"]
end

subgraph group_runtime["Render runtime"]
  node_engine["Frame engine<br/>[engine.js]"]
  node_features["Timing features<br/>[features.js]"]
  node_drawing["Canvas drawing<br/>[draw.js]"]
  node_post["Post processing<br/>[post.js]"]
  node_transitions["Shot transitions<br/>[transitions.js]"]
  node_art["Character artwork<br/>[art.js]"]
end

subgraph group_story["Film and visuals"]
  node_registry["Scene registry<br/>[index.js]"]
  node_sections["Song sections"]
  node_overlays["Warning and credits<br/>[overlay.js]"]
  node_scene_kit["Scene toolkit<br/>[kit.js]"]
  node_chat["Chat interface<br/>[chat.js]"]
  node_code["Code visuals<br/>[code.js]"]
  node_plates["Print illustrations<br/>[plate.js]"]
  node_motif["Recurring motif<br/>[motif.js]"]
end

node_creator(("Video creator"))
node_audio["Song audio"]
node_video["Rendered video"]

node_creator -->|"supplies lyrics"| node_lyrics
node_lyrics -->|"prepares lyrics"| node_preview
node_creator -->|"starts preview"| node_preview
node_creator -->|"requests export"| node_exporter
node_creator -->|"supplies song"| node_audio
node_exporter -->|"starts server"| node_server
node_exporter -->|"receives frames"| node_frames
node_exporter -.->|"encodes video"| node_video
node_preview -->|"renders frames"| node_engine
node_exporter -.->|"renders frames"| node_engine
node_engine -->|"uses timing"| node_features
node_engine -->|"draws layers"| node_drawing
node_engine -->|"applies effects"| node_post
node_engine -->|"resolves transitions"| node_transitions
node_engine -->|"loads artwork"| node_art
node_engine -->|"builds scenes"| node_registry
node_registry -->|"loads sections"| node_sections
node_registry -->|"adds overlay"| node_overlays
node_registry -->|"builds fallback"| node_scene_kit
node_scene_kit -->|"draws interface"| node_chat
node_sections -.->|"uses interface"| node_chat
node_sections -.->|"uses code visuals"| node_code
node_sections -.->|"uses print visuals"| node_plates
node_chat -->|"draws motif"| node_motif

click node_lyrics "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/tools/fill_lyrics.mjs"
click node_preview "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/main.js"
click node_exporter "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/export/export.mjs"
click node_server "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/export/server.mjs"
click node_frames "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/export/wsframes.mjs"
click node_engine "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/engine.js"
click node_features "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/features.js"
click node_drawing "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/draw.js"
click node_post "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/post.js"
click node_transitions "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/transitions.js"
click node_art "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/art.js"
click node_registry "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/scenes/index.js"
click node_sections "https://github.com/nyankomintsu/world-execute-me-lyric-mv/tree/main/src/scenes"
click node_overlays "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/scenes/overlay.js"
click node_scene_kit "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/scenes/kit.js"
click node_chat "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/components/chat.js"
click node_code "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/components/code.js"
click node_plates "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/components/plate.js"
click node_motif "https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/components/motif.js"

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_lyrics,node_preview,node_exporter,node_server,node_frames toneBlue
class node_engine,node_features,node_drawing,node_post,node_transitions,node_art toneAmber
class node_registry,node_sections,node_overlays,node_scene_kit,node_chat,node_code,node_plates,node_motif toneMint
class node_creator,node_audio,node_video toneIndigo
```

## Components

### Input and export

- [Lyric matching](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/tools/fill_lyrics.mjs): `tools/fill_lyrics.mjs`
- [Browser preview](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/main.js): `src/main.js`
- [Frame exporter](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/export/export.mjs): `export/export.mjs`
- [Local server](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/export/server.mjs): `export/server.mjs`
- [Frame transport](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/export/wsframes.mjs): `export/wsframes.mjs`

### Render runtime

- [Frame engine](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/engine.js): `src/engine/engine.js`
- [Timing features](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/features.js): `src/engine/features.js`
- [Canvas drawing](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/draw.js): `src/engine/draw.js`
- [Post processing](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/post.js): `src/engine/post.js`
- [Shot transitions](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/transitions.js): `src/engine/transitions.js`
- [Character artwork](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/engine/art.js): `src/engine/art.js`

### Film and visuals

- [Scene registry](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/scenes/index.js): `src/scenes/index.js`
- [Song sections](https://github.com/nyankomintsu/world-execute-me-lyric-mv/tree/main/src/scenes): `src/scenes`
- [Warning and credits](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/scenes/overlay.js): `src/scenes/overlay.js`
- [Scene toolkit](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/scenes/kit.js): `src/scenes/kit.js`
- [Chat interface](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/components/chat.js): `src/components/chat.js`
- [Code visuals](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/components/code.js): `src/components/code.js`
- [Print illustrations](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/components/plate.js): `src/components/plate.js`
- [Recurring motif](https://github.com/nyankomintsu/world-execute-me-lyric-mv/blob/main/src/components/motif.js): `src/components/motif.js`

### Other components

- **Video creator**
- **Song audio**
- **Rendered video**

## Connections

- Video creator → Lyric matching: supplies lyrics (evidence: `README.md`)
- Lyric matching → Browser preview: prepares lyrics
- Video creator → Browser preview: starts preview (evidence: `README.md`)
- Video creator → Frame exporter: requests export (evidence: `README.md`)
- Video creator → Song audio: supplies song (evidence: `README.md`)
- Frame exporter → Local server: starts server (evidence: `export/export.mjs`)
- Frame exporter → Frame transport: receives frames (evidence: `export/export.mjs`)
- Frame exporter → Rendered video: encodes video (evidence: `README.md`)
- Browser preview → Frame engine: renders frames (evidence: `src/main.js`)
- Frame exporter → Frame engine: renders frames (evidence: `README.md`)
- Frame engine → Timing features: uses timing (evidence: `src/engine/engine.js`)
- Frame engine → Canvas drawing: draws layers (evidence: `src/engine/engine.js`)
- Frame engine → Post processing: applies effects (evidence: `src/engine/engine.js`)
- Frame engine → Shot transitions: resolves transitions (evidence: `src/engine/engine.js`)
- Frame engine → Character artwork: loads artwork (evidence: `src/engine/engine.js`)
- Frame engine → Scene registry: builds scenes (evidence: `src/engine/engine.js`)
- Scene registry → Song sections: loads sections (evidence: `src/scenes/index.js`)
- Scene registry → Warning and credits: adds overlay (evidence: `src/scenes/index.js`)
- Scene registry → Scene toolkit: builds fallback (evidence: `src/scenes/index.js`)
- Scene toolkit → Chat interface: draws interface (evidence: `src/scenes/kit.js`)
- Song sections → Chat interface: uses interface (evidence: `src/scenes/10_error.js`)
- Song sections → Code visuals: uses code visuals (evidence: `src/scenes/10_error.js`)
- Song sections → Print illustrations: uses print visuals (evidence: `src/scenes/climax.js`)
- Chat interface → Recurring motif: draws motif (evidence: `src/components/chat.js`)
