# thufailahd654-ops/lovemenot-oled_animation architecture

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

- Interactive diagram: https://gitdiagram.com/thufailahd654-ops/lovemenot-oled_animation
- Repository: https://github.com/thufailahd654-ops/lovemenot-oled_animation

## Overview

This is an embedded animation player: the ESP32-C3 sketch reads bitmap frames stored in PROGMEM and displays them on an SSD1306 OLED, looping at about 24 fps. The README documents the playback flow and hardware; no source excerpts were provided, so relationships are limited to those documented there.

Main entry points: [`oled_i_miss_you.ino`](https://github.com/thufailahd654-ops/lovemenot-oled_animation/blob/main/oled_i_miss_you.ino) (Animation Player), [`VideoFrame.h`](https://github.com/thufailahd654-ops/lovemenot-oled_animation/blob/main/VideoFrame.h) (Bitmap Frames)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_esp32(("ESP32-C3 Mini"))
node_player["Animation Player"]
node_frames["Bitmap Frames<br/>[VideoFrame.h]"]
node_oled["SSD1306 OLED"]

node_esp32 -->|"runs"| node_player
node_player -->|"reads frames"| node_frames
node_player -->|"displays animation"| node_oled

click node_player "https://github.com/thufailahd654-ops/lovemenot-oled_animation/blob/main/oled_i_miss_you.ino"
click node_frames "https://github.com/thufailahd654-ops/lovemenot-oled_animation/blob/main/VideoFrame.h"

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_esp32,node_oled toneIndigo
class node_player,node_frames toneTeal
```

## Components

### Other components

- **ESP32-C3 Mini**
- [Animation Player](https://github.com/thufailahd654-ops/lovemenot-oled_animation/blob/main/oled_i_miss_you.ino): `oled_i_miss_you.ino`
- [Bitmap Frames](https://github.com/thufailahd654-ops/lovemenot-oled_animation/blob/main/VideoFrame.h): `VideoFrame.h`
- **SSD1306 OLED**

## Connections

- ESP32-C3 Mini → Animation Player: runs (evidence: `README.md`)
- Animation Player → Bitmap Frames: reads frames (evidence: `README.md`)
- Animation Player → SSD1306 OLED: displays animation (evidence: `README.md`)