# ankush-naskar/watch-list-app architecture

> Architecture diagram of the GitHub repository ankush-naskar/watch-list-app, 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/ankush-naskar/watch-list-app
- Repository: https://github.com/ankush-naskar/watch-list-app

## Overview

This is a desktop watchlist for tracking anime, movies, manga, and comics. The main workflow starts the Tkinter GUI, loads and filters saved entries, and displays them with progress, link, edit, and delete controls. A modal form adds or edits entries, optionally fetching poster bytes from the entered URL; the GUI then refreshes the list. SQLite provides persistent watchlist storage. The README is empty, so the map relies on the sampled source; no broader capabilities are documented.

Main entry points: [`GUI/main_gui_window.py`](https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/main_gui_window.py) (Watchlist window), [`GUI/add_new.py`](https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/add_new.py) (Add/edit form), [`data_handler.py`](https://github.com/ankush-naskar/watch-list-app/blob/main/data_handler.py) (Watchlist operations), [`run.py`](https://github.com/ankush-naskar/watch-list-app/blob/main/run.py) (App launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_launcher["App launcher<br/>[run.py]"]
  node_main["Watchlist window<br/>[main_gui_window.py]"]
  node_listing["Entry cards<br/>[main_gui_window.py]"]
  node_actions["Entry actions<br/>[main_gui_window.py]"]
end

subgraph group_entry["Watchlist editing"]
  node_form["Add/edit form<br/>[add_new.py]"]
  node_poster["Poster fetch<br/>[add_new.py]"]
end

subgraph group_storage["Local persistence"]
  node_data["Watchlist operations<br/>[data_handler.py]"]
  node_sqlite[("SQLite watchlist<br/>[data_handler.py]")]
end

node_user(("User"))
node_browser["Web browser"]

node_user -->|"starts"| node_launcher
node_launcher -->|"creates"| node_main
node_user -.->|"uses"| node_main
node_main -->|"loads entries"| node_data
node_main -->|"renders"| node_listing
node_user -.->|"selects"| node_actions
node_actions -->|"updates entries"| node_data
node_actions -->|"opens links"| node_browser
node_main -->|"opens form"| node_form
node_form -->|"requests image"| node_poster
node_poster -->|"returns bytes"| node_form
node_form -->|"saves entry"| node_data
node_data -->|"reads and writes"| node_sqlite

click node_launcher "https://github.com/ankush-naskar/watch-list-app/blob/main/run.py"
click node_main "https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/main_gui_window.py"
click node_listing "https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/main_gui_window.py"
click node_actions "https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/main_gui_window.py"
click node_form "https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/add_new.py"
click node_poster "https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/add_new.py"
click node_data "https://github.com/ankush-naskar/watch-list-app/blob/main/data_handler.py"
click node_sqlite "https://github.com/ankush-naskar/watch-list-app/blob/main/data_handler.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_launcher,node_main,node_listing,node_actions,node_user,node_browser toneBlue
class node_form,node_poster toneAmber
class node_data,node_sqlite toneMint
```

## Components

### Desktop interface

- [App launcher](https://github.com/ankush-naskar/watch-list-app/blob/main/run.py): `run.py`
- [Watchlist window](https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/main_gui_window.py): `GUI/main_gui_window.py`
- [Entry cards](https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/main_gui_window.py): `GUI/main_gui_window.py`
- [Entry actions](https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/main_gui_window.py): `GUI/main_gui_window.py`

### Watchlist editing

- [Add/edit form](https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/add_new.py): `GUI/add_new.py`
- [Poster fetch](https://github.com/ankush-naskar/watch-list-app/blob/main/GUI/add_new.py): `GUI/add_new.py`

### Local persistence

- [Watchlist operations](https://github.com/ankush-naskar/watch-list-app/blob/main/data_handler.py): `data_handler.py`
- [SQLite watchlist](https://github.com/ankush-naskar/watch-list-app/blob/main/data_handler.py): `data_handler.py`

### Other components

- **User**
- **Web browser**

## Connections

- User → App launcher: starts (evidence: `run.py`)
- App launcher → Watchlist window: creates (evidence: `run.py`)
- User → Watchlist window: uses
- Watchlist window → Watchlist operations: loads entries (evidence: `GUI/main_gui_window.py`)
- Watchlist window → Entry cards: renders (evidence: `GUI/main_gui_window.py`)
- User → Entry actions: selects
- Entry actions → Watchlist operations: updates entries (evidence: `GUI/main_gui_window.py`)
- Entry actions → Web browser: opens links (evidence: `GUI/main_gui_window.py`)
- Watchlist window → Add/edit form: opens form (evidence: `GUI/main_gui_window.py`)
- Add/edit form → Poster fetch: requests image (evidence: `GUI/add_new.py`)
- Poster fetch → Add/edit form: returns bytes (evidence: `GUI/add_new.py`)
- Add/edit form → Watchlist operations: saves entry (evidence: `GUI/add_new.py`)
- Watchlist operations → SQLite watchlist: reads and writes (evidence: `data_handler.py`)
