# hugomd/ascii-live architecture

> Architecture diagram of the GitHub repository hugomd/ascii-live, 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/hugomd/ascii-live
- Repository: https://github.com/hugomd/ascii-live

## Overview

ascii.live serves looping ASCII animations over HTTP to curl clients. The main workflow routes a request to an animation, checks that it exists and that the client identifies as curl, then streams frames until the client disconnects; `/list` exposes available names. The README documents a catalog of contributed animations. The animation registry and playback type are represented together because the source excerpt does not show their implementation; the README supports the registration relationships, but individual registrations were not inspected.

Main entry points: [`frames/frames.go`](https://github.com/hugomd/ascii-live/blob/master/frames/frames.go) (Frame registry and type), [`main.go`](https://github.com/hugomd/ascii-live/blob/master/main.go) (HTTP routes and playback), [`frames/astrend.go`](https://github.com/hugomd/ascii-live/blob/master/frames/astrend.go) (Astrend), [`frames/batman&robin.go`](https://github.com/hugomd/ascii-live/blob/master/frames/batman%26robin.go) (Batman & Robin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["HTTP server"]
  node_http_server["HTTP routes and playback<br/>[main.go]"]
end

subgraph group_catalog["Animation catalog"]
  node_frame_registry["Frame registry and type<br/>[frames.go]"]
end

subgraph group_art["Animation frames"]
  node_astrend["Astrend<br/>[astrend.go]"]
  node_batman_robin["Batman &amp; Robin<br/>[batman&amp;robin.go]"]
  node_batman["Batman<br/>[batman.go]"]
  node_bomb["Bomb<br/>[bomb.go]"]
  node_brittany["Brittany<br/>[brittany.go]"]
  node_coin["Coin<br/>[coin.go]"]
  node_donut["Donut<br/>[donut.go]"]
  node_dvd["DVD<br/>[dvd.go]"]
  node_earth["Earth<br/>[earth.go]"]
  node_forrest["Forrest<br/>[forrest.go]"]
  node_india["India<br/>[india.go]"]
  node_kitty["Kitty<br/>[kitty.go]"]
  node_knot["Torus knot<br/>[knot.go]"]
  node_maxwell["Maxwell<br/>[maxwell.go]"]
  node_nebulaehes["Nebulae HES<br/>[nebulaehes.go]"]
  node_nyan["Nyan<br/>[nyan.go]"]
  node_parrot["Parrot<br/>[parrot.go]"]
  node_purdue["Purdue<br/>[purdue.go]"]
  node_rick["Rick<br/>[rick.go]"]
  node_spidyswing["Spidy swing<br/>[spidyswing.go]"]
  node_time["Time<br/>[time.go]"]
end

node_curl_user(("Terminal user"))

node_curl_user -->|"requests animation"| node_http_server
node_http_server -->|"looks up frames"| node_frame_registry
node_frame_registry -->|"maps animation"| node_astrend
node_frame_registry -->|"maps animation"| node_batman_robin
node_frame_registry -->|"maps animation"| node_batman
node_frame_registry -->|"maps animation"| node_bomb
node_frame_registry -->|"maps animation"| node_brittany
node_frame_registry -->|"maps animation"| node_coin
node_frame_registry -->|"maps animation"| node_donut
node_frame_registry -->|"maps animation"| node_dvd
node_frame_registry -->|"maps animation"| node_earth
node_frame_registry -->|"maps animation"| node_forrest
node_frame_registry -->|"maps animation"| node_india
node_frame_registry -->|"maps animation"| node_kitty
node_frame_registry -->|"maps animation"| node_knot
node_frame_registry -->|"maps animation"| node_maxwell
node_frame_registry -->|"maps animation"| node_nebulaehes
node_frame_registry -->|"maps animation"| node_nyan
node_frame_registry -->|"maps animation"| node_parrot
node_frame_registry -->|"maps animation"| node_purdue
node_frame_registry -->|"maps animation"| node_rick
node_frame_registry -->|"maps animation"| node_spidyswing
node_frame_registry -->|"maps animation"| node_time

click node_http_server "https://github.com/hugomd/ascii-live/blob/master/main.go"
click node_frame_registry "https://github.com/hugomd/ascii-live/blob/master/frames/frames.go"
click node_astrend "https://github.com/hugomd/ascii-live/blob/master/frames/astrend.go"
click node_batman_robin "https://github.com/hugomd/ascii-live/blob/master/frames/batman%26robin.go"
click node_batman "https://github.com/hugomd/ascii-live/blob/master/frames/batman.go"
click node_bomb "https://github.com/hugomd/ascii-live/blob/master/frames/bomb.go"
click node_brittany "https://github.com/hugomd/ascii-live/blob/master/frames/brittany.go"
click node_coin "https://github.com/hugomd/ascii-live/blob/master/frames/coin.go"
click node_donut "https://github.com/hugomd/ascii-live/blob/master/frames/donut.go"
click node_dvd "https://github.com/hugomd/ascii-live/blob/master/frames/dvd.go"
click node_earth "https://github.com/hugomd/ascii-live/blob/master/frames/earth.go"
click node_forrest "https://github.com/hugomd/ascii-live/blob/master/frames/forrest.go"
click node_india "https://github.com/hugomd/ascii-live/blob/master/frames/india.go"
click node_kitty "https://github.com/hugomd/ascii-live/blob/master/frames/kitty.go"
click node_knot "https://github.com/hugomd/ascii-live/blob/master/frames/knot.go"
click node_maxwell "https://github.com/hugomd/ascii-live/blob/master/frames/maxwell.go"
click node_nebulaehes "https://github.com/hugomd/ascii-live/blob/master/frames/nebulaehes.go"
click node_nyan "https://github.com/hugomd/ascii-live/blob/master/frames/nyan.go"
click node_parrot "https://github.com/hugomd/ascii-live/blob/master/frames/parrot.go"
click node_purdue "https://github.com/hugomd/ascii-live/blob/master/frames/purdue.go"
click node_rick "https://github.com/hugomd/ascii-live/blob/master/frames/rick.go"
click node_spidyswing "https://github.com/hugomd/ascii-live/blob/master/frames/spidyswing.go"
click node_time "https://github.com/hugomd/ascii-live/blob/master/frames/time.go"

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_http_server,node_curl_user toneBlue
class node_frame_registry toneAmber
class node_astrend,node_batman_robin,node_batman,node_bomb,node_brittany,node_coin,node_donut,node_dvd,node_earth,node_forrest,node_india,node_kitty,node_knot,node_maxwell,node_nebulaehes,node_nyan,node_parrot,node_purdue,node_rick,node_spidyswing,node_time toneMint
```

## Components

### HTTP server

- [HTTP routes and playback](https://github.com/hugomd/ascii-live/blob/master/main.go): `main.go`

### Animation catalog

- [Frame registry and type](https://github.com/hugomd/ascii-live/blob/master/frames/frames.go): `frames/frames.go`

### Animation frames

- [Astrend](https://github.com/hugomd/ascii-live/blob/master/frames/astrend.go): `frames/astrend.go`
- [Batman & Robin](https://github.com/hugomd/ascii-live/blob/master/frames/batman%26robin.go): `frames/batman&robin.go`
- [Batman](https://github.com/hugomd/ascii-live/blob/master/frames/batman.go): `frames/batman.go`
- [Bomb](https://github.com/hugomd/ascii-live/blob/master/frames/bomb.go): `frames/bomb.go`
- [Brittany](https://github.com/hugomd/ascii-live/blob/master/frames/brittany.go): `frames/brittany.go`
- [Coin](https://github.com/hugomd/ascii-live/blob/master/frames/coin.go): `frames/coin.go`
- [Donut](https://github.com/hugomd/ascii-live/blob/master/frames/donut.go): `frames/donut.go`
- [DVD](https://github.com/hugomd/ascii-live/blob/master/frames/dvd.go): `frames/dvd.go`
- [Earth](https://github.com/hugomd/ascii-live/blob/master/frames/earth.go): `frames/earth.go`
- [Forrest](https://github.com/hugomd/ascii-live/blob/master/frames/forrest.go): `frames/forrest.go`
- [India](https://github.com/hugomd/ascii-live/blob/master/frames/india.go): `frames/india.go`
- [Kitty](https://github.com/hugomd/ascii-live/blob/master/frames/kitty.go): `frames/kitty.go`
- [Torus knot](https://github.com/hugomd/ascii-live/blob/master/frames/knot.go): `frames/knot.go`
- [Maxwell](https://github.com/hugomd/ascii-live/blob/master/frames/maxwell.go): `frames/maxwell.go`
- [Nebulae HES](https://github.com/hugomd/ascii-live/blob/master/frames/nebulaehes.go): `frames/nebulaehes.go`
- [Nyan](https://github.com/hugomd/ascii-live/blob/master/frames/nyan.go): `frames/nyan.go`
- [Parrot](https://github.com/hugomd/ascii-live/blob/master/frames/parrot.go): `frames/parrot.go`
- [Purdue](https://github.com/hugomd/ascii-live/blob/master/frames/purdue.go): `frames/purdue.go`
- [Rick](https://github.com/hugomd/ascii-live/blob/master/frames/rick.go): `frames/rick.go`
- [Spidy swing](https://github.com/hugomd/ascii-live/blob/master/frames/spidyswing.go): `frames/spidyswing.go`
- [Time](https://github.com/hugomd/ascii-live/blob/master/frames/time.go): `frames/time.go`

### Other components

- **Terminal user**

## Connections

- Terminal user → HTTP routes and playback: requests animation (evidence: `README.md`)
- HTTP routes and playback → Frame registry and type: looks up frames (evidence: `main.go`)
- Frame registry and type → Astrend: maps animation (evidence: `README.md`)
- Frame registry and type → Batman & Robin: maps animation (evidence: `README.md`)
- Frame registry and type → Batman: maps animation (evidence: `README.md`)
- Frame registry and type → Bomb: maps animation (evidence: `README.md`)
- Frame registry and type → Brittany: maps animation (evidence: `README.md`)
- Frame registry and type → Coin: maps animation (evidence: `README.md`)
- Frame registry and type → Donut: maps animation (evidence: `README.md`)
- Frame registry and type → DVD: maps animation (evidence: `README.md`)
- Frame registry and type → Earth: maps animation (evidence: `README.md`)
- Frame registry and type → Forrest: maps animation (evidence: `README.md`)
- Frame registry and type → India: maps animation (evidence: `README.md`)
- Frame registry and type → Kitty: maps animation (evidence: `README.md`)
- Frame registry and type → Torus knot: maps animation (evidence: `README.md`)
- Frame registry and type → Maxwell: maps animation (evidence: `README.md`)
- Frame registry and type → Nebulae HES: maps animation (evidence: `README.md`)
- Frame registry and type → Nyan: maps animation (evidence: `README.md`)
- Frame registry and type → Parrot: maps animation (evidence: `README.md`)
- Frame registry and type → Purdue: maps animation (evidence: `README.md`)
- Frame registry and type → Rick: maps animation (evidence: `README.md`)
- Frame registry and type → Spidy swing: maps animation (evidence: `README.md`)
- Frame registry and type → Time: maps animation (evidence: `README.md`)
