# bagpotato/ascii-chill architecture

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

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

## Overview

ascii · chill is a collection of real-time, colored ASCII terminal animations, with an interactive menu as the main entry point. A user selects a scene; the menu imports that scene and calls its main function, which runs the animation in the terminal until interrupted. The five scene scripts are self-contained rather than sharing a rendering library. The README documents their common frame-generation and ANSI-output recipe; only some scene implementations were sampled, so scene-to-terminal edges rely on that documentation.

Main entry points: [`menu.py`](https://github.com/bagpotato/ascii-chill/blob/main/menu.py) (Scene menu), [`art.py`](https://github.com/bagpotato/ascii-chill/blob/main/art.py) (Black hole), [`starry_night.py`](https://github.com/bagpotato/ascii-chill/blob/main/starry_night.py) (Starry Night), [`campfire.py`](https://github.com/bagpotato/ascii-chill/blob/main/campfire.py) (Campfire)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launcher["Scene launcher"]
  node_menu["Scene menu<br/>[menu.py]"]
end

subgraph group_scenes["Terminal animations"]
  node_blackhole["Black hole<br/>[art.py]"]
  node_starry["Starry Night<br/>[starry_night.py]"]
  node_campfire["Campfire<br/>[campfire.py]"]
  node_coffee["Coffee<br/>[coffee.py]"]
  node_cat["Sleeping cat<br/>[cat.py]"]
end

node_user(("Terminal user"))
node_terminal["Terminal display"]

node_user -->|"selects scene"| node_menu
node_menu -->|"launches"| node_blackhole
node_menu -->|"launches"| node_starry
node_menu -->|"launches"| node_campfire
node_menu -->|"launches"| node_coffee
node_menu -->|"launches"| node_cat
node_blackhole -->|"writes frames"| node_terminal
node_starry -->|"writes frames"| node_terminal
node_campfire -->|"writes frames"| node_terminal
node_coffee -->|"writes frames"| node_terminal
node_cat -->|"writes frames"| node_terminal

click node_menu "https://github.com/bagpotato/ascii-chill/blob/main/menu.py"
click node_blackhole "https://github.com/bagpotato/ascii-chill/blob/main/art.py"
click node_starry "https://github.com/bagpotato/ascii-chill/blob/main/starry_night.py"
click node_campfire "https://github.com/bagpotato/ascii-chill/blob/main/campfire.py"
click node_coffee "https://github.com/bagpotato/ascii-chill/blob/main/coffee.py"
click node_cat "https://github.com/bagpotato/ascii-chill/blob/main/cat.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_menu,node_user toneBlue
class node_blackhole,node_starry,node_campfire,node_coffee,node_cat toneAmber
class node_terminal toneIndigo
```

## Components

### Scene launcher

- [Scene menu](https://github.com/bagpotato/ascii-chill/blob/main/menu.py): `menu.py`

### Terminal animations

- [Black hole](https://github.com/bagpotato/ascii-chill/blob/main/art.py): `art.py`
- [Starry Night](https://github.com/bagpotato/ascii-chill/blob/main/starry_night.py): `starry_night.py`
- [Campfire](https://github.com/bagpotato/ascii-chill/blob/main/campfire.py): `campfire.py`
- [Coffee](https://github.com/bagpotato/ascii-chill/blob/main/coffee.py): `coffee.py`
- [Sleeping cat](https://github.com/bagpotato/ascii-chill/blob/main/cat.py): `cat.py`

### Other components

- **Terminal user**
- **Terminal display**

## Connections

- Terminal user → Scene menu: selects scene (evidence: `menu.py`)
- Scene menu → Black hole: launches (evidence: `menu.py`)
- Scene menu → Starry Night: launches (evidence: `menu.py`)
- Scene menu → Campfire: launches (evidence: `menu.py`)
- Scene menu → Coffee: launches (evidence: `menu.py`)
- Scene menu → Sleeping cat: launches (evidence: `menu.py`)
- Black hole → Terminal display: writes frames (evidence: `README.md`)
- Starry Night → Terminal display: writes frames (evidence: `README.md`)
- Campfire → Terminal display: writes frames (evidence: `README.md`)
- Coffee → Terminal display: writes frames (evidence: `README.md`)
- Sleeping cat → Terminal display: writes frames (evidence: `README.md`)
