# spikesix/minload architecture

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

- Interactive diagram: https://gitdiagram.com/spikesix/minload
- Repository: https://github.com/spikesix/minload

## Overview

Minload Studio is a Qt desktop GUI for downloading audio and converting it with yt-dlp and ffmpeg. The user opens the main window, enters a URL, selects an output folder and format, then starts the download/conversion workflow; the UI displays command output and progress. A separate conversion window is explicitly under construction. The sampled source shows process and progress handling, but omits the command construction and much of the process wiring, so external-tool links rely on README statements.

Main entry points: [`Source Code/Code/mainwindow.cpp`](https://github.com/spikesix/minload/blob/main/Source%20Code/Code/mainwindow.cpp) (Download process), [`Source Code/Code/main.cpp`](https://github.com/spikesix/minload/blob/main/Source%20Code/Code/main.cpp) (Qt entry point), [`Source Code/Code/convertwindow.cpp`](https://github.com/spikesix/minload/blob/main/Source%20Code/Code/convertwindow.cpp) (Conversion window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Application startup"]
  node_entry["Qt entry point<br/>[main.cpp]"]
end

subgraph group_interface["Desktop interface"]
  node_main_window["Main window<br/>[mainwindow.cpp]"]
  node_convert_window["Conversion window<br/>[convertwindow.cpp]"]
end

subgraph group_media["Media workflow"]
  node_audio_ui["Audio download UI<br/>[mainwindow.cpp]"]
  node_media_process["Download process<br/>[mainwindow.cpp]"]
  node_ytdlp["yt-dlp"]
  node_ffmpeg["ffmpeg"]
  node_output_folder[("Output folder")]
end

node_user(("User"))

node_user -->|"launches"| node_entry
node_entry -->|"creates and shows"| node_main_window
node_user -.->|"uses"| node_main_window
node_main_window -->|"opens"| node_convert_window
node_main_window -->|"provides"| node_audio_ui
node_audio_ui -->|"starts"| node_media_process
node_media_process -->|"downloads with"| node_ytdlp
node_media_process -->|"converts with"| node_ffmpeg
node_media_process -->|"writes media"| node_output_folder

click node_entry "https://github.com/spikesix/minload/blob/main/Source%20Code/Code/main.cpp"
click node_main_window "https://github.com/spikesix/minload/blob/main/Source%20Code/Code/mainwindow.cpp"
click node_convert_window "https://github.com/spikesix/minload/blob/main/Source%20Code/Code/convertwindow.cpp"
click node_audio_ui "https://github.com/spikesix/minload/blob/main/Source%20Code/Code/mainwindow.cpp"
click node_media_process "https://github.com/spikesix/minload/blob/main/Source%20Code/Code/mainwindow.cpp"

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_entry,node_user toneBlue
class node_main_window,node_convert_window toneAmber
class node_audio_ui,node_media_process,node_ytdlp,node_ffmpeg,node_output_folder toneMint
```

## Components

### Application startup

- [Qt entry point](https://github.com/spikesix/minload/blob/main/Source%20Code/Code/main.cpp): `Source Code/Code/main.cpp`

### Desktop interface

- [Main window](https://github.com/spikesix/minload/blob/main/Source%20Code/Code/mainwindow.cpp): `Source Code/Code/mainwindow.cpp`
- [Conversion window](https://github.com/spikesix/minload/blob/main/Source%20Code/Code/convertwindow.cpp): `Source Code/Code/convertwindow.cpp`

### Media workflow

- [Audio download UI](https://github.com/spikesix/minload/blob/main/Source%20Code/Code/mainwindow.cpp): `Source Code/Code/mainwindow.cpp`
- [Download process](https://github.com/spikesix/minload/blob/main/Source%20Code/Code/mainwindow.cpp): `Source Code/Code/mainwindow.cpp`
- **yt-dlp**
- **ffmpeg**
- **Output folder**

### Other components

- **User**

## Connections

- User → Qt entry point: launches
- Qt entry point → Main window: creates and shows (evidence: `Source Code/Code/main.cpp`)
- User → Main window: uses
- Main window → Conversion window: opens (evidence: `Source Code/Code/mainwindow.cpp`)
- Main window → Audio download UI: provides (evidence: `Source Code/Code/mainwindow.cpp`)
- Audio download UI → Download process: starts (evidence: `Source Code/Code/mainwindow.cpp`)
- Download process → yt-dlp: downloads with (evidence: `README.md`)
- Download process → ffmpeg: converts with (evidence: `README.md`)
- Download process → Output folder: writes media (evidence: `README.md`)
