# ajaykumar-ak10/qr-generator architecture

> Architecture diagram of the GitHub repository ajaykumar-ak10/qr-generator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ajaykumar-ak10/qr-generator
- Repository: https://github.com/ajaykumar-ak10/qr-generator

## Overview

This small application generates QR codes from validated website URLs through either a Tkinter desktop interface or a separate command-line script. The desktop workflow supports size and color selection, on-screen preview, PNG download, clearing, About information, and status messages. Generation and file handling are implemented directly in the GUI module; the CLI independently generates and saves a default QR code. The graph reflects the sampled source; README-described GUI actions are included where their wiring is visible in that source.

Main entry points: [`qr_gui.py`](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py) (QR encoder), [`qr_generator.py`](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_generator.py) (CLI QR creation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop app"]
  node_gui["GUI controls<br/>[qr_gui.py]"]
  node_validation["URL validation<br/>[qr_gui.py]"]
  node_options["Color and size<br/>[qr_gui.py]"]
  node_preview["QR preview<br/>[qr_gui.py]"]
  node_download["PNG download<br/>[qr_gui.py]"]
  node_file_dialog["Save dialog"]
  node_clear["Clear action<br/>[qr_gui.py]"]
  node_about_status["About and status<br/>[qr_gui.py]"]
end

subgraph group_generation["QR generation"]
  node_encoder["QR encoder<br/>[qr_gui.py]"]
  node_qr_library["qrcode library"]
  node_png_file[("QR PNG file<br/>[qr_gui.py]")]
end

subgraph group_cli["Command line"]
  node_cli["CLI prompt<br/>[qr_generator.py]"]
  node_cli_validation["CLI validation<br/>[qr_generator.py]"]
  node_cli_encoder["CLI QR creation<br/>[qr_generator.py]"]
  node_cli_output[("CLI PNG output<br/>[qr_generator.py]")]
end

node_user(("User"))

node_user -->|"uses"| node_gui
node_gui -->|"generates via"| node_validation
node_validation -->|"accepts valid URL"| node_options
node_options -->|"configures"| node_encoder
node_encoder -->|"creates code with"| node_qr_library
node_encoder -->|"saves"| node_png_file
node_encoder -->|"displays resized image"| node_preview
node_user -->|"requests"| node_download
node_download -->|"opens and saves"| node_png_file
node_download -->|"chooses destination"| node_file_dialog
node_user -->|"requests"| node_clear
node_user -->|"views"| node_about_status
node_cli -->|"checks URL"| node_cli_validation
node_cli_validation -->|"creates code with"| node_cli_encoder
node_cli_encoder -->|"creates code with"| node_qr_library
node_cli_encoder -->|"saves PNG"| node_cli_output

click node_gui "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py"
click node_validation "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py"
click node_options "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py"
click node_encoder "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py"
click node_png_file "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py"
click node_preview "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py"
click node_download "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py"
click node_clear "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py"
click node_about_status "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py"
click node_cli "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_generator.py"
click node_cli_validation "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_generator.py"
click node_cli_encoder "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_generator.py"
click node_cli_output "https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_generator.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_gui,node_validation,node_options,node_preview,node_download,node_file_dialog,node_clear,node_about_status,node_user toneBlue
class node_encoder,node_qr_library,node_png_file toneAmber
class node_cli,node_cli_validation,node_cli_encoder,node_cli_output toneMint
```

## Components

### Desktop app

- [GUI controls](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py): `qr_gui.py`
- [URL validation](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py): `qr_gui.py`
- [Color and size](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py): `qr_gui.py`
- [QR preview](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py): `qr_gui.py`
- [PNG download](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py): `qr_gui.py`
- **Save dialog**
- [Clear action](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py): `qr_gui.py`
- [About and status](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py): `qr_gui.py`

### QR generation

- [QR encoder](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py): `qr_gui.py`
- **qrcode library**
- [QR PNG file](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_gui.py): `qr_gui.py`

### Command line

- [CLI prompt](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_generator.py): `qr_generator.py`
- [CLI validation](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_generator.py): `qr_generator.py`
- [CLI QR creation](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_generator.py): `qr_generator.py`
- [CLI PNG output](https://github.com/ajaykumar-ak10/qr-generator/blob/main/qr_generator.py): `qr_generator.py`

### Other components

- **User**

## Connections

- User → GUI controls: uses (evidence: `README.md`)
- GUI controls → URL validation: generates via (evidence: `qr_gui.py`)
- URL validation → Color and size: accepts valid URL (evidence: `qr_gui.py`)
- Color and size → QR encoder: configures (evidence: `qr_gui.py`)
- QR encoder → qrcode library: creates code with (evidence: `qr_gui.py`)
- QR encoder → QR PNG file: saves (evidence: `qr_gui.py`)
- QR encoder → QR preview: displays resized image (evidence: `qr_gui.py`)
- User → PNG download: requests (evidence: `README.md`)
- PNG download → QR PNG file: opens and saves (evidence: `qr_gui.py`)
- PNG download → Save dialog: chooses destination (evidence: `qr_gui.py`)
- User → Clear action: requests (evidence: `README.md`)
- User → About and status: views (evidence: `README.md`)
- CLI prompt → CLI validation: checks URL (evidence: `qr_generator.py`)
- CLI validation → CLI QR creation: creates code with (evidence: `qr_generator.py`)
- CLI QR creation → qrcode library: creates code with (evidence: `qr_generator.py`)
- CLI QR creation → CLI PNG output: saves PNG (evidence: `qr_generator.py`)
