# malloydelacroix/downloaderforreddit architecture

> Architecture diagram of the GitHub repository malloydelacroix/downloaderforreddit, 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/malloydelacroix/downloaderforreddit
- Repository: https://github.com/malloydelacroix/downloaderforreddit

## Overview

Downloader For Reddit is a desktop application for retrieving Reddit users’ and subreddits’ posts, linked media, self text, and comments. Users configure targets and download options, then the application extracts and filters content, downloads files, and records extracted data in SQLite; users can inspect, filter, and export that data. The graph covers the documented scheduling, settings, and output capabilities as well. Some of those subsystem links are dashed because their implementation was not sampled.

Main entry points: [`DownloaderForReddit/gui/downloader_for_reddit_gui.py`](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/gui/downloader_for_reddit_gui.py) (Main window), [`DownloaderForReddit/gui/database_views/database_dialog.py`](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/gui/database_views/database_dialog.py) (Database browser), [`DownloaderForReddit/core/submission_handler.py`](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/submission_handler.py) (Submission handler), [`DownloaderForReddit/extractors/base_extractor.py`](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/extractors/base_extractor.py) (Site extractors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_app["Application entry<br/>[main.py]"]
  node_gui["Main window"]
  node_dbview["Database browser<br/>[database_dialog.py]"]
  node_stats["Database statistics"]
end

subgraph group_collection["Reddit collection"]
  node_auth["Reddit authentication<br/>[user_auth.py]"]
  node_downloadrun["Download runner<br/>[download_runner.py]"]
  node_submission["Submission handler"]
  node_comments["Comment handler<br/>[comment_handler.py]"]
  node_filters["Content filters<br/>[content_filter.py]"]
end

subgraph group_media["Extraction and downloads"]
  node_extractors["Site extractors<br/>[base_extractor.py]"]
  node_downloader["File downloader<br/>[downloader.py]"]
  node_merger["Video merger<br/>[video_merger.py]"]
end

subgraph group_data["Data and preferences"]
  node_models["Reddit data models<br/>[models.py]"]
  node_sqlite[("SQLite database")]
  node_dbmanager["Database operations<br/>[model_manager.py]"]
  node_dbfilters["Database filters<br/>[filters.py]"]
  node_settings["Settings manager"]
end

subgraph group_support["Scheduling and output"]
  node_scheduler["Download scheduler<br/>[scheduler.py]"]
  node_export["Data import and export"]
  node_messages["Message queue<br/>[message.py]"]
end

node_user(("User"))

node_user -->|"configures and starts"| node_gui
node_app -->|"starts"| node_gui
node_app -.->|"initializes"| node_settings
node_gui -->|"starts downloads"| node_downloadrun
node_gui -->|"uses authentication"| node_auth
node_gui -->|"opens"| node_dbview
node_gui -->|"opens"| node_stats
node_gui -.->|"configures"| node_settings
node_gui -.->|"schedules downloads"| node_scheduler
node_downloadrun -.->|"processes submissions"| node_submission
node_submission -->|"handles comments"| node_comments
node_submission -->|"selects and invokes"| node_extractors
node_submission -->|"uses post data"| node_models
node_submission -->|"reports errors"| node_messages
node_extractors -->|"filters extracted content"| node_filters
node_extractors -->|"creates content records"| node_models
node_extractors -.->|"queues content"| node_downloader
node_downloader -.->|"merges video files"| node_merger
node_models -->|"persists records"| node_sqlite
node_dbview -->|"queries and displays"| node_models
node_dbview -->|"applies filters"| node_dbfilters
node_dbview -->|"delegates data operations"| node_dbmanager
node_stats -->|"summarizes records"| node_models
node_dbview -.->|"exports selected data"| node_export
node_gui -.->|"displays output"| node_messages
node_settings -->|"configures extractors"| node_extractors
node_scheduler -.->|"triggers runs"| node_downloadrun
node_user -->|"reviews extracted data"| node_dbview

click node_app "https://github.com/malloydelacroix/downloaderforreddit/blob/master/main.py"
click node_gui "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/gui/downloader_for_reddit_gui.py"
click node_dbview "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/gui/database_views/database_dialog.py"
click node_stats "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/gui/database_views/database_statistics_dialog.py"
click node_auth "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/user_auth.py"
click node_downloadrun "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/download_runner.py"
click node_submission "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/submission_handler.py"
click node_comments "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/comment_handler.py"
click node_filters "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/content_filter.py"
click node_extractors "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/extractors/base_extractor.py"
click node_downloader "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/download/downloader.py"
click node_merger "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/utils/video_merger.py"
click node_models "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/database/models.py"
click node_sqlite "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/database/database_handler.py"
click node_dbmanager "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/database/model_manager.py"
click node_dbfilters "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/database/filters.py"
click node_settings "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/persistence/settings_manager.py"
click node_scheduler "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/scheduling/scheduler.py"
click node_export "https://github.com/malloydelacroix/downloaderforreddit/tree/master/DownloaderForReddit/utils/exporters"
click node_messages "https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/messaging/message.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_app,node_gui,node_dbview,node_stats,node_user toneBlue
class node_auth,node_downloadrun,node_submission,node_comments,node_filters toneAmber
class node_extractors,node_downloader,node_merger toneMint
class node_models,node_sqlite,node_dbmanager,node_dbfilters,node_settings toneRose
class node_scheduler,node_export,node_messages toneIndigo
```

## Components

### Desktop interface

- [Application entry](https://github.com/malloydelacroix/downloaderforreddit/blob/master/main.py): `main.py`
- [Main window](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/gui/downloader_for_reddit_gui.py): `DownloaderForReddit/gui/downloader_for_reddit_gui.py`
- [Database browser](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/gui/database_views/database_dialog.py): `DownloaderForReddit/gui/database_views/database_dialog.py`
- [Database statistics](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/gui/database_views/database_statistics_dialog.py): `DownloaderForReddit/gui/database_views/database_statistics_dialog.py`

### Reddit collection

- [Reddit authentication](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/user_auth.py): `DownloaderForReddit/core/user_auth.py`
- [Download runner](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/download_runner.py): `DownloaderForReddit/core/download_runner.py`
- [Submission handler](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/submission_handler.py): `DownloaderForReddit/core/submission_handler.py`
- [Comment handler](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/comment_handler.py): `DownloaderForReddit/core/comment_handler.py`
- [Content filters](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/content_filter.py): `DownloaderForReddit/core/content_filter.py`

### Extraction and downloads

- [Site extractors](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/extractors/base_extractor.py): `DownloaderForReddit/extractors/base_extractor.py`
- [File downloader](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/core/download/downloader.py): `DownloaderForReddit/core/download/downloader.py`
- [Video merger](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/utils/video_merger.py): `DownloaderForReddit/utils/video_merger.py`

### Data and preferences

- [Reddit data models](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/database/models.py): `DownloaderForReddit/database/models.py`
- [SQLite database](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/database/database_handler.py): `DownloaderForReddit/database/database_handler.py`
- [Database operations](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/database/model_manager.py): `DownloaderForReddit/database/model_manager.py`
- [Database filters](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/database/filters.py): `DownloaderForReddit/database/filters.py`
- [Settings manager](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/persistence/settings_manager.py): `DownloaderForReddit/persistence/settings_manager.py`

### Scheduling and output

- [Download scheduler](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/scheduling/scheduler.py): `DownloaderForReddit/scheduling/scheduler.py`
- [Data import and export](https://github.com/malloydelacroix/downloaderforreddit/tree/master/DownloaderForReddit/utils/exporters): `DownloaderForReddit/utils/exporters`
- [Message queue](https://github.com/malloydelacroix/downloaderforreddit/blob/master/DownloaderForReddit/messaging/message.py): `DownloaderForReddit/messaging/message.py`

### Other components

- **User**

## Connections

- User → Main window: configures and starts
- Application entry → Main window: starts (evidence: `main.py`)
- Application entry → Settings manager: initializes
- Main window → Download runner: starts downloads (evidence: `DownloaderForReddit/gui/downloader_for_reddit_gui.py`)
- Main window → Reddit authentication: uses authentication (evidence: `DownloaderForReddit/gui/downloader_for_reddit_gui.py`)
- Main window → Database browser: opens (evidence: `DownloaderForReddit/gui/downloader_for_reddit_gui.py`)
- Main window → Database statistics: opens (evidence: `DownloaderForReddit/gui/downloader_for_reddit_gui.py`)
- Main window → Settings manager: configures
- Main window → Download scheduler: schedules downloads
- Download runner → Submission handler: processes submissions
- Submission handler → Comment handler: handles comments (evidence: `DownloaderForReddit/core/submission_handler.py`)
- Submission handler → Site extractors: selects and invokes (evidence: `DownloaderForReddit/core/submission_handler.py`)
- Submission handler → Reddit data models: uses post data (evidence: `DownloaderForReddit/core/submission_handler.py`)
- Submission handler → Message queue: reports errors (evidence: `DownloaderForReddit/core/submission_handler.py`)
- Site extractors → Content filters: filters extracted content (evidence: `DownloaderForReddit/extractors/base_extractor.py`)
- Site extractors → Reddit data models: creates content records (evidence: `DownloaderForReddit/extractors/base_extractor.py`)
- Site extractors → File downloader: queues content
- File downloader → Video merger: merges video files
- Reddit data models → SQLite database: persists records (evidence: `DownloaderForReddit/database/models.py`)
- Database browser → Reddit data models: queries and displays (evidence: `DownloaderForReddit/gui/database_views/database_dialog.py`)
- Database browser → Database filters: applies filters (evidence: `DownloaderForReddit/gui/database_views/database_dialog.py`)
- Database browser → Database operations: delegates data operations (evidence: `DownloaderForReddit/gui/database_views/database_dialog.py`)
- Database statistics → Reddit data models: summarizes records (evidence: `DownloaderForReddit/gui/database_views/database_statistics_dialog.py`)
- Database browser → Data import and export: exports selected data
- Main window → Message queue: displays output (evidence: `DownloaderForReddit/gui/downloader_for_reddit_gui.py`)
- Settings manager → Site extractors: configures extractors (evidence: `DownloaderForReddit/persistence/settings_manager.py`)
- Download scheduler → Download runner: triggers runs
- User → Database browser: reviews extracted data
