# jin2-ascii/-jin2-ascii architecture

> Architecture diagram of the GitHub repository jin2-ascii/-jin2-ascii, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jin2-ascii/-jin2-ascii
- Repository: https://github.com/jin2-ascii/-jin2-ascii

## Overview

JIN2 is a portfolio of standalone Python ASCII-code artworks, rather than one shared application. The principal workflow is to run an artwork’s script, which produces an animated visual piece; several scripts expose pause, restart, screenshot, and quit controls. The works include procedural scenes, text-driven pieces, and frame-based animations. The excerpts show rendering and interaction patterns for sampled works, but do not establish shared runtime modules or connections between artworks, so the graph treats each piece as an independent entry point.

Main entry points: [`SKIPPED-A-BEAT/skipped_a_beat.py`](https://github.com/jin2-ascii/-jin2-ascii/blob/main/SKIPPED-A-BEAT/skipped_a_beat.py) (Skipped a Beat), [`BIRTHDAY-CAKE/birthday_cake.py`](https://github.com/jin2-ascii/-jin2-ascii/blob/main/BIRTHDAY-CAKE/birthday_cake.py) (Birthday Cake), [`BLACK-HOLE/black_hole.py`](https://github.com/jin2-ascii/-jin2-ascii/blob/main/BLACK-HOLE/black_hole.py) (Black Hole), [`DIAMOND-RING/diamond_ring.py`](https://github.com/jin2-ascii/-jin2-ascii/blob/main/DIAMOND-RING/diamond_ring.py) (Diamond Ring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_procedural["Procedural scenes"]
  node_birthday["Birthday Cake<br/>[birthday_cake.py]"]
  node_blackhole["Black Hole<br/>[black_hole.py]"]
  node_diamond["Diamond Ring<br/>[diamond_ring.py]"]
  node_flip["Flip Phone<br/>[flip_phone.py]"]
  node_night["Night Tide<br/>[night_tide.py]"]
  node_rose["Rose<br/>[rose.py]"]
  node_snowman["Snowman<br/>[snowman.py]"]
end

subgraph group_text["Text-led works"]
  node_goodluck["Good Luck<br/>[good_luck.py]"]
  node_iloveyou["I Love You<br/>[i_love_you.py]"]
  node_money["Money Rain<br/>[money_rain.py]"]
end

subgraph group_frames["Frame-based works"]
  node_cat["Cat Knight<br/>[cat_knight.py]"]
  node_skipped["Skipped a Beat<br/>[skipped_a_beat.py]"]
  node_heart["Skipped Beat Frames"]
end

subgraph group_other["Other artworks"]
end

node_viewer(("Viewer"))

node_viewer -->|"runs"| node_birthday
node_viewer -->|"runs"| node_blackhole
node_viewer -->|"runs"| node_diamond
node_viewer -->|"runs"| node_flip
node_viewer -->|"runs"| node_night
node_viewer -->|"runs"| node_rose
node_viewer -->|"runs"| node_snowman
node_viewer -->|"runs"| node_goodluck
node_viewer -->|"runs"| node_iloveyou
node_viewer -->|"runs"| node_money
node_viewer -->|"runs"| node_cat
node_viewer -->|"runs"| node_skipped
node_skipped -->|"loads frames"| node_heart

click node_birthday "https://github.com/jin2-ascii/-jin2-ascii/blob/main/BIRTHDAY-CAKE/birthday_cake.py"
click node_blackhole "https://github.com/jin2-ascii/-jin2-ascii/blob/main/BLACK-HOLE/black_hole.py"
click node_diamond "https://github.com/jin2-ascii/-jin2-ascii/blob/main/DIAMOND-RING/diamond_ring.py"
click node_flip "https://github.com/jin2-ascii/-jin2-ascii/blob/main/FLIP-PHONE/flip_phone.py"
click node_night "https://github.com/jin2-ascii/-jin2-ascii/blob/main/NIGHT-TIDE/night_tide.py"
click node_rose "https://github.com/jin2-ascii/-jin2-ascii/blob/main/ROSE/rose.py"
click node_snowman "https://github.com/jin2-ascii/-jin2-ascii/blob/main/SNOWMAN/snowman.py"
click node_goodluck "https://github.com/jin2-ascii/-jin2-ascii/blob/main/GOOD-LUCK/good_luck.py"
click node_iloveyou "https://github.com/jin2-ascii/-jin2-ascii/blob/main/I-LOVE-YOU/i_love_you.py"
click node_money "https://github.com/jin2-ascii/-jin2-ascii/blob/main/MONEY-RAIN/money_rain.py"
click node_cat "https://github.com/jin2-ascii/-jin2-ascii/blob/main/CAT-KNIGHT/cat_knight.py"
click node_skipped "https://github.com/jin2-ascii/-jin2-ascii/blob/main/SKIPPED-A-BEAT/skipped_a_beat.py"
click node_heart "https://github.com/jin2-ascii/-jin2-ascii/blob/main/SKIPPED-A-BEAT/skipped_a_beat_frames.npz"

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_birthday,node_blackhole,node_diamond,node_flip,node_night,node_rose,node_snowman,node_viewer toneBlue
class node_goodluck,node_iloveyou,node_money toneAmber
class node_cat,node_skipped,node_heart toneMint
```

## Components

### Procedural scenes

- [Birthday Cake](https://github.com/jin2-ascii/-jin2-ascii/blob/main/BIRTHDAY-CAKE/birthday_cake.py): `BIRTHDAY-CAKE/birthday_cake.py`
- [Black Hole](https://github.com/jin2-ascii/-jin2-ascii/blob/main/BLACK-HOLE/black_hole.py): `BLACK-HOLE/black_hole.py`
- [Diamond Ring](https://github.com/jin2-ascii/-jin2-ascii/blob/main/DIAMOND-RING/diamond_ring.py): `DIAMOND-RING/diamond_ring.py`
- [Flip Phone](https://github.com/jin2-ascii/-jin2-ascii/blob/main/FLIP-PHONE/flip_phone.py): `FLIP-PHONE/flip_phone.py`
- [Night Tide](https://github.com/jin2-ascii/-jin2-ascii/blob/main/NIGHT-TIDE/night_tide.py): `NIGHT-TIDE/night_tide.py`
- [Rose](https://github.com/jin2-ascii/-jin2-ascii/blob/main/ROSE/rose.py): `ROSE/rose.py`
- [Snowman](https://github.com/jin2-ascii/-jin2-ascii/blob/main/SNOWMAN/snowman.py): `SNOWMAN/snowman.py`

### Text-led works

- [Good Luck](https://github.com/jin2-ascii/-jin2-ascii/blob/main/GOOD-LUCK/good_luck.py): `GOOD-LUCK/good_luck.py`
- [I Love You](https://github.com/jin2-ascii/-jin2-ascii/blob/main/I-LOVE-YOU/i_love_you.py): `I-LOVE-YOU/i_love_you.py`
- [Money Rain](https://github.com/jin2-ascii/-jin2-ascii/blob/main/MONEY-RAIN/money_rain.py): `MONEY-RAIN/money_rain.py`

### Frame-based works

- [Cat Knight](https://github.com/jin2-ascii/-jin2-ascii/blob/main/CAT-KNIGHT/cat_knight.py): `CAT-KNIGHT/cat_knight.py`
- [Skipped a Beat](https://github.com/jin2-ascii/-jin2-ascii/blob/main/SKIPPED-A-BEAT/skipped_a_beat.py): `SKIPPED-A-BEAT/skipped_a_beat.py`
- [Skipped Beat Frames](https://github.com/jin2-ascii/-jin2-ascii/blob/main/SKIPPED-A-BEAT/skipped_a_beat_frames.npz): `SKIPPED-A-BEAT/skipped_a_beat_frames.npz`

### Other components

- **Viewer**

## Connections

- Viewer → Birthday Cake: runs (evidence: `BIRTHDAY-CAKE/birthday_cake.py`)
- Viewer → Black Hole: runs (evidence: `BLACK-HOLE/black_hole.py`)
- Viewer → Diamond Ring: runs (evidence: `DIAMOND-RING/diamond_ring.py`)
- Viewer → Flip Phone: runs (evidence: `FLIP-PHONE/flip_phone.py`)
- Viewer → Night Tide: runs (evidence: `NIGHT-TIDE/night_tide.py`)
- Viewer → Rose: runs (evidence: `ROSE/rose.py`)
- Viewer → Snowman: runs (evidence: `SNOWMAN/snowman.py`)
- Viewer → Good Luck: runs (evidence: `GOOD-LUCK/good_luck.py`)
- Viewer → I Love You: runs (evidence: `I-LOVE-YOU/i_love_you.py`)
- Viewer → Money Rain: runs (evidence: `MONEY-RAIN/money_rain.py`)
- Viewer → Cat Knight: runs (evidence: `CAT-KNIGHT/cat_knight.py`)
- Viewer → Skipped a Beat: runs (evidence: `SKIPPED-A-BEAT/skipped_a_beat.py`)
- Skipped a Beat → Skipped Beat Frames: loads frames (evidence: `SKIPPED-A-BEAT/skipped_a_beat.py`)
