# gil-x/strip-animation-js architecture

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

- Interactive diagram: https://gitdiagram.com/gil-x/strip-animation-js
- Repository: https://github.com/gil-x/strip-animation-js

## Overview

This repository is a small browser animation demo plus its image-preparation tools. A visitor opens the page; JavaScript loads the vertical frame strip, then updates the player’s background position at a fixed rate, reversing at each end. Separate Python utilities normalize Blender frame filenames and assemble numbered frames into the strip. The README documents these preparation steps and the browser workflow; the HTML and CSS were not sampled, so their detailed wiring is not represented.

Main entry points: [`js/main.js`](https://github.com/gil-x/strip-animation-js/blob/master/js/main.js) (Frame playback), [`strip.py`](https://github.com/gil-x/strip-animation-js/blob/master/strip.py) (Strip generator), [`index.html`](https://github.com/gil-x/strip-animation-js/blob/master/index.html) (Animation player), [`media`](https://github.com/gil-x/strip-animation-js/tree/master/media) (Vertical strip)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser playback"]
  node_page["Demo page<br/>[index.html]"]
  node_player["Animation player<br/>[index.html]"]
  node_playback["Frame playback<br/>[main.js]"]
  node_styling["Player styling<br/>[main.css]"]
  node_strip_asset["Vertical strip"]
end

subgraph group_prep["Image preparation"]
  node_frame_files["Numbered frames"]
  node_renamer["Frame renamer<br/>[renamer.py]"]
  node_generator["Strip generator<br/>[strip.py]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_page
node_playback -->|"updates frames"| node_player
node_playback -->|"loads"| node_strip_asset
node_styling -->|"styles"| node_player
node_renamer -->|"renames"| node_frame_files
node_generator -->|"reads frames"| node_frame_files
node_generator -->|"writes strip"| node_strip_asset

click node_page "https://github.com/gil-x/strip-animation-js/blob/master/index.html"
click node_player "https://github.com/gil-x/strip-animation-js/blob/master/index.html"
click node_playback "https://github.com/gil-x/strip-animation-js/blob/master/js/main.js"
click node_styling "https://github.com/gil-x/strip-animation-js/blob/master/css/main.css"
click node_strip_asset "https://github.com/gil-x/strip-animation-js/tree/master/media"
click node_frame_files "https://github.com/gil-x/strip-animation-js/tree/master/media"
click node_renamer "https://github.com/gil-x/strip-animation-js/blob/master/renamer.py"
click node_generator "https://github.com/gil-x/strip-animation-js/blob/master/strip.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_page,node_player,node_playback,node_styling,node_strip_asset toneBlue
class node_frame_files,node_renamer,node_generator toneAmber
class node_visitor toneIndigo
```

## Components

### Browser playback

- [Demo page](https://github.com/gil-x/strip-animation-js/blob/master/index.html): `index.html`
- [Animation player](https://github.com/gil-x/strip-animation-js/blob/master/index.html): `index.html`
- [Frame playback](https://github.com/gil-x/strip-animation-js/blob/master/js/main.js): `js/main.js`
- [Player styling](https://github.com/gil-x/strip-animation-js/blob/master/css/main.css): `css/main.css`
- [Vertical strip](https://github.com/gil-x/strip-animation-js/tree/master/media): `media`

### Image preparation

- [Numbered frames](https://github.com/gil-x/strip-animation-js/tree/master/media): `media`
- [Frame renamer](https://github.com/gil-x/strip-animation-js/blob/master/renamer.py): `renamer.py`
- [Strip generator](https://github.com/gil-x/strip-animation-js/blob/master/strip.py): `strip.py`

### Other components

- **Visitor**

## Connections

- Visitor → Demo page: opens (evidence: `README.md`)
- Frame playback → Animation player: updates frames (evidence: `js/main.js`)
- Frame playback → Vertical strip: loads (evidence: `js/main.js`)
- Player styling → Animation player: styles (evidence: `README.md`)
- Frame renamer → Numbered frames: renames (evidence: `README.md`)
- Strip generator → Numbered frames: reads frames (evidence: `README.md`)
- Strip generator → Vertical strip: writes strip (evidence: `README.md`)
