# openselena/libreget architecture

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

- Interactive diagram: https://gitdiagram.com/openselena/libreget
- Repository: https://github.com/openselena/libreget

## Overview

LibreGet is a cross-platform desktop downloader and media toolbox. The primary workflow starts when a user submits a URL: the app identifies a supported site, previews available media, downloads it through a native extractor or yt-dlp, and saves it locally for later use. The product also includes course-platform integrations, a resumable queue, browser-extension cookie capture, Bilibili previews, Telegram, conversion, and a broad set of post-download tools. The README supports the high-level workflow; source excerpts and the index provide only selective implementation evidence, so unsampled connections are omitted.

Main entry points: [`src/routes/+page.svelte`](https://github.com/openselena/libreget/blob/main/src/routes/%2Bpage.svelte) (Home workflow), [`src-tauri/src/core/url_parser.rs`](https://github.com/openselena/libreget/blob/main/src-tauri/src/core/url_parser.rs) (URL detection), [`src-tauri/src/core/queue.rs`](https://github.com/openselena/libreget/blob/main/src-tauri/src/core/queue.rs) (Download queue), [`src-tauri/libreget-core/src/core/ytdlp.rs`](https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/core/ytdlp.rs) (Download engines)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_home["Home workflow<br/>[+page.svelte]"]
end

subgraph group_download["Download pipeline"]
  node_parser["URL detection<br/>[url_parser.rs]"]
  node_queue["Download queue<br/>[queue.rs]"]
  node_downloader["Download engines<br/>[ytdlp.rs]"]
  node_media["Media models<br/>[media.rs]"]
end

subgraph group_integrations["Site integrations"]
  node_extension["Browser extension<br/>[bridge-client.js]"]
  node_platforms["Media platforms<br/>[mod.rs]"]
  node_bili_preview["Bilibili preview<br/>[preview.rs]"]
  node_bili_api["Bilibili API<br/>[api.rs]"]
  node_courses["Course platforms<br/>[mod.rs]"]
  node_telegram["Telegram<br/>[+page.svelte]"]
end

subgraph group_local["Local data"]
  node_queue_store[("Queue state<br/>[queue_wal.rs]")]
  node_cookies[("Cookie manager<br/>[storage.rs]")]
  node_extension_store[("Extension data")]
  node_local_files[("Saved files")]
end

subgraph group_extras["Media tools"]
  node_tools["Post-download tools<br/>[mod.rs]"]
  node_convert["Conversion plugin<br/>[lib.rs]"]
  node_player["Media viewing"]
end

node_user(("User"))

node_user -->|"submits link"| node_home
node_home -->|"detects site"| node_parser
node_parser -->|"selects extractor"| node_platforms
node_parser -->|"routes course URL"| node_courses
node_home -->|"queues download"| node_queue
node_queue -->|"dispatches download"| node_downloader
node_queue -.->|"persists queue"| node_queue_store
node_downloader -->|"writes files"| node_local_files
node_downloader -.->|"produces media"| node_media
node_extension -->|"sends capture data"| node_extension_store
node_extension_store -.->|"supplies browser cookies"| node_cookies
node_home -.->|"previews Bilibili"| node_bili_preview
node_bili_preview -->|"requests metadata"| node_bili_api
node_bili_api -->|"uses HTTP client"| node_platforms
node_user -.->|"opens Telegram"| node_telegram
node_local_files -->|"opens saved media"| node_player
node_local_files -->|"processes saved files"| node_tools
node_local_files -->|"converts media"| node_convert

click node_home "https://github.com/openselena/libreget/blob/main/src/routes/%2Bpage.svelte"
click node_parser "https://github.com/openselena/libreget/blob/main/src-tauri/src/core/url_parser.rs"
click node_queue "https://github.com/openselena/libreget/blob/main/src-tauri/src/core/queue.rs"
click node_downloader "https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/core/ytdlp.rs"
click node_media "https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/models/media.rs"
click node_queue_store "https://github.com/openselena/libreget/blob/main/src-tauri/src/core/queue_wal.rs"
click node_cookies "https://github.com/openselena/libreget/blob/main/src-tauri/src/cookies/storage.rs"
click node_extension "https://github.com/openselena/libreget/blob/main/browser-extension/chrome/src/bridge-client.js"
click node_extension_store "https://github.com/openselena/libreget/blob/main/src-tauri/src/extension_storage.rs"
click node_platforms "https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/platforms/mod.rs"
click node_bili_preview "https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/platforms/bilibili/preview.rs"
click node_bili_api "https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/platforms/bilibili/api.rs"
click node_courses "https://github.com/openselena/libreget/blob/main/src-tauri/plugins/courses/src/platforms/mod.rs"
click node_telegram "https://github.com/openselena/libreget/blob/main/src/routes/telegram/%2Bpage.svelte"
click node_tools "https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/core/tools/mod.rs"
click node_convert "https://github.com/openselena/libreget/blob/main/src-tauri/plugins/convert/src/lib.rs"
click node_player "https://github.com/openselena/libreget/blob/main/src/components/librebox/MediaPreview.svelte"

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_home,node_user toneBlue
class node_parser,node_queue,node_downloader,node_media toneAmber
class node_extension,node_platforms,node_bili_preview,node_bili_api,node_courses,node_telegram toneMint
class node_queue_store,node_cookies,node_extension_store,node_local_files toneRose
class node_tools,node_convert,node_player toneIndigo
```

## Components

### Desktop app

- [Home workflow](https://github.com/openselena/libreget/blob/main/src/routes/%2Bpage.svelte): `src/routes/+page.svelte`

### Download pipeline

- [URL detection](https://github.com/openselena/libreget/blob/main/src-tauri/src/core/url_parser.rs): `src-tauri/src/core/url_parser.rs`
- [Download queue](https://github.com/openselena/libreget/blob/main/src-tauri/src/core/queue.rs): `src-tauri/src/core/queue.rs`
- [Download engines](https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/core/ytdlp.rs): `src-tauri/libreget-core/src/core/ytdlp.rs`
- [Media models](https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/models/media.rs): `src-tauri/libreget-core/src/models/media.rs`

### Site integrations

- [Browser extension](https://github.com/openselena/libreget/blob/main/browser-extension/chrome/src/bridge-client.js): `browser-extension/chrome/src/bridge-client.js`
- [Media platforms](https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/platforms/mod.rs): `src-tauri/libreget-core/src/platforms/mod.rs`
- [Bilibili preview](https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/platforms/bilibili/preview.rs): `src-tauri/libreget-core/src/platforms/bilibili/preview.rs`
- [Bilibili API](https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/platforms/bilibili/api.rs): `src-tauri/libreget-core/src/platforms/bilibili/api.rs`
- [Course platforms](https://github.com/openselena/libreget/blob/main/src-tauri/plugins/courses/src/platforms/mod.rs): `src-tauri/plugins/courses/src/platforms/mod.rs`
- [Telegram](https://github.com/openselena/libreget/blob/main/src/routes/telegram/%2Bpage.svelte): `src/routes/telegram/+page.svelte`

### Local data

- [Queue state](https://github.com/openselena/libreget/blob/main/src-tauri/src/core/queue_wal.rs): `src-tauri/src/core/queue_wal.rs`
- [Cookie manager](https://github.com/openselena/libreget/blob/main/src-tauri/src/cookies/storage.rs): `src-tauri/src/cookies/storage.rs`
- [Extension data](https://github.com/openselena/libreget/blob/main/src-tauri/src/extension_storage.rs): `src-tauri/src/extension_storage.rs`
- **Saved files**

### Media tools

- [Post-download tools](https://github.com/openselena/libreget/blob/main/src-tauri/libreget-core/src/core/tools/mod.rs): `src-tauri/libreget-core/src/core/tools/mod.rs`
- [Conversion plugin](https://github.com/openselena/libreget/blob/main/src-tauri/plugins/convert/src/lib.rs): `src-tauri/plugins/convert/src/lib.rs`
- [Media viewing](https://github.com/openselena/libreget/blob/main/src/components/librebox/MediaPreview.svelte): `src/components/librebox/MediaPreview.svelte`

### Other components

- **User**

## Connections

- User → Home workflow: submits link (evidence: `README.md`)
- Home workflow → URL detection: detects site (evidence: `README.md`)
- URL detection → Media platforms: selects extractor (evidence: `README.md`)
- URL detection → Course platforms: routes course URL (evidence: `README.md`)
- Home workflow → Download queue: queues download (evidence: `README.md`)
- Download queue → Download engines: dispatches download (evidence: `README.md`)
- Download queue → Queue state: persists queue
- Download engines → Saved files: writes files (evidence: `README.md`)
- Download engines → Media models: produces media
- Browser extension → Extension data: sends capture data (evidence: `src-tauri/src/extension_storage.rs`)
- Extension data → Cookie manager: supplies browser cookies (evidence: `src-tauri/src/cookies/storage.rs`)
- Home workflow → Bilibili preview: previews Bilibili
- Bilibili preview → Bilibili API: requests metadata (evidence: `src-tauri/libreget-core/src/platforms/bilibili/preview.rs`)
- Bilibili API → Media platforms: uses HTTP client (evidence: `src-tauri/libreget-core/src/platforms/bilibili/api.rs`)
- User → Telegram: opens Telegram
- Saved files → Media viewing: opens saved media (evidence: `README.md`)
- Saved files → Post-download tools: processes saved files (evidence: `README.md`)
- Saved files → Conversion plugin: converts media (evidence: `README.md`)
