# ultimatemilkman/piano-youtube-tutorial-to-image-converter architecture

> Architecture diagram of the GitHub repository ultimatemilkman/piano-youtube-tutorial-to-image-converter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ultimatemilkman/piano-youtube-tutorial-to-image-converter
- Repository: https://github.com/ultimatemilkman/piano-youtube-tutorial-to-image-converter
- Video tour (about a minute): https://gitdiagram.com/ultimatemilkman/piano-youtube-tutorial-to-image-converter/video

## Overview

This is a small Python utility for turning a manually captured, one-pixel-tall piano-tutorial GIF into one or more tall PNG images. The user captures the GIF with GifCam, configures and runs the script, then can stretch or crop the PNG in an image editor. The script reads GIF frames, reverses each batch vertically, and saves batches capped at 9,000 pixels tall. The graph is based on the single excerpted source file and README workflow.

Main entry points: [`pianogif2.py`](https://github.com/ultimatemilkman/piano-youtube-tutorial-to-image-converter/blob/main/pianogif2.py) (GIF converter)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_gifcam["GifCam capture"]
node_input_gif["One-pixel GIF"]
node_converter["GIF converter<br/>[pianogif2.py]"]
node_png_output["Tall PNG images"]
node_image_editor["Image editor"]

node_user -->|"records video"| node_gifcam
node_gifcam -->|"saves GIF"| node_input_gif
node_user -->|"configures and runs"| node_converter
node_converter -->|"reads frames"| node_input_gif
node_converter -->|"saves PNG batches"| node_png_output
node_user -->|"opens output"| node_image_editor
node_png_output -->|"post-processes"| node_image_editor

click node_converter "https://github.com/ultimatemilkman/piano-youtube-tutorial-to-image-converter/blob/main/pianogif2.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_user toneBlue
class node_gifcam,node_input_gif,node_png_output,node_image_editor toneIndigo
class node_converter toneTeal
```

## Components

### Other components

- **User**
- **GifCam capture**
- **One-pixel GIF**
- [GIF converter](https://github.com/ultimatemilkman/piano-youtube-tutorial-to-image-converter/blob/main/pianogif2.py): `pianogif2.py`
- **Tall PNG images**
- **Image editor**

## Connections

- User → GifCam capture: records video (evidence: `README.md`)
- GifCam capture → One-pixel GIF: saves GIF (evidence: `README.md`)
- User → GIF converter: configures and runs (evidence: `README.md`)
- GIF converter → One-pixel GIF: reads frames (evidence: `pianogif2.py`)
- GIF converter → Tall PNG images: saves PNG batches (evidence: `pianogif2.py`)
- User → Image editor: opens output (evidence: `README.md`)
- Tall PNG images → Image editor: post-processes (evidence: `README.md`)
