# walidmahmoud101/udemy-downloader-gui architecture

> Architecture diagram of the GitHub repository walidmahmoud101/udemy-downloader-gui, 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/walidmahmoud101/udemy-downloader-gui
- Repository: https://github.com/walidmahmoud101/udemy-downloader-gui

## Overview

Udeler is a cross-platform Electron app for downloading courses the user is enrolled in on Udemy. The documented user journey is to authenticate with Udemy, select courses, and download their lecture videos; settings also expose choices for attachments, subtitles, video quality, and download location. The graph includes the Electron window and renderer, persistent settings, and documented download stages. The main UI implementation is present in the tree but its excerpt was not supplied, so its internal calls and download handoffs are not mapped; those workflow links rely on README documentation.

Main entry points: [`app/renderer.js`](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/renderer.js) (Renderer bootstrap), [`app/app.js`](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/app.js) (Course downloads), [`main.js`](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/main.js) (Electron shell), [`app/js/auto_authenticator.js`](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/js/auto_authenticator.js) (Udemy authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop shell"]
  node_electron["Electron shell<br/>[main.js]"]
  node_renderer["Renderer bootstrap<br/>[renderer.js]"]
end

subgraph group_workflow["Course workflow"]
  node_ui["Downloader interface<br/>[app.js]"]
  node_auth["Udemy authentication"]
  node_course_select["Course selection<br/>[app.js]"]
  node_course_download["Course downloads<br/>[app.js]"]
  node_download_options["Download options<br/>[settings.js]"]
  node_local_files["Downloaded course files"]
end

subgraph group_prefs["Preferences and localization"]
  node_settings_store[("Settings store<br/>[settings.js]")]
  node_translations["Translations"]
end

subgraph group_services["External services"]
  node_udemy["Udemy"]
  node_feature_config["Feature toggles"]
  node_sentry["Sentry"]
end

node_user(("User"))

node_user -->|"opens app"| node_electron
node_electron -->|"loads window"| node_renderer
node_renderer -.->|"loads interface"| node_ui
node_renderer -->|"loads settings"| node_settings_store
node_renderer -->|"fetches toggles"| node_feature_config
node_renderer -->|"configures reporting"| node_sentry
node_renderer -->|"loads locale metadata"| node_translations
node_user -->|"provides credentials"| node_auth
node_auth -.->|"authenticates"| node_udemy
node_user -->|"chooses courses"| node_course_select
node_course_select -.->|"starts downloads"| node_course_download
node_course_download -->|"gets course videos"| node_udemy
node_course_download -.->|"uses options"| node_download_options
node_course_download -->|"writes downloads"| node_local_files
node_download_options -->|"persists preferences"| node_settings_store

click node_electron "https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/main.js"
click node_renderer "https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/renderer.js"
click node_ui "https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/app.js"
click node_auth "https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/js/auto_authenticator.js"
click node_course_select "https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/app.js"
click node_course_download "https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/app.js"
click node_download_options "https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/js/settings.js"
click node_settings_store "https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/js/settings.js"
click node_translations "https://github.com/walidmahmoud101/udemy-downloader-gui/tree/master/app/locale"

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_electron,node_renderer,node_user toneBlue
class node_ui,node_auth,node_course_select,node_course_download,node_download_options,node_local_files toneAmber
class node_settings_store,node_translations toneMint
class node_udemy,node_feature_config,node_sentry toneRose
```

## Components

### Desktop shell

- [Electron shell](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/main.js): `main.js`
- [Renderer bootstrap](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/renderer.js): `app/renderer.js`

### Course workflow

- [Downloader interface](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/app.js): `app/app.js`
- [Udemy authentication](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/js/auto_authenticator.js): `app/js/auto_authenticator.js`
- [Course selection](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/app.js): `app/app.js`
- [Course downloads](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/app.js): `app/app.js`
- [Download options](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/js/settings.js): `app/js/settings.js`
- **Downloaded course files**

### Preferences and localization

- [Settings store](https://github.com/walidmahmoud101/udemy-downloader-gui/blob/master/app/js/settings.js): `app/js/settings.js`
- [Translations](https://github.com/walidmahmoud101/udemy-downloader-gui/tree/master/app/locale): `app/locale`

### External services

- **Udemy**
- **Feature toggles**
- **Sentry**

### Other components

- **User**

## Connections

- User → Electron shell: opens app (evidence: `README.md`)
- Electron shell → Renderer bootstrap: loads window (evidence: `main.js`)
- Renderer bootstrap → Downloader interface: loads interface
- Renderer bootstrap → Settings store: loads settings (evidence: `app/renderer.js`)
- Renderer bootstrap → Feature toggles: fetches toggles (evidence: `app/renderer.js`)
- Renderer bootstrap → Sentry: configures reporting (evidence: `app/renderer.js`)
- Renderer bootstrap → Translations: loads locale metadata (evidence: `app/renderer.js`)
- User → Udemy authentication: provides credentials (evidence: `README.md`)
- Udemy authentication → Udemy: authenticates
- User → Course selection: chooses courses (evidence: `README.md`)
- Course selection → Course downloads: starts downloads (evidence: `app/app.js`)
- Course downloads → Udemy: gets course videos (evidence: `README.md`)
- Course downloads → Download options: uses options
- Course downloads → Downloaded course files: writes downloads (evidence: `README.md`)
- Download options → Settings store: persists preferences (evidence: `app/js/settings.js`)
