# kaos599/maglev architecture

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

## Overview

Maglev is an Android download manager, video downloader and torrent client. Users discover links through its browser, torrent search, feeds, or shared input, then add transfers and manage them in the transfers and detail screens. The app’s EngineContext mediates UI operations with the engine; the Android host and Rust core provide native transfer execution. Other major product branches include subtitles, optional assistant-guided downloads, and browser protections. Some subsystem internals were not sampled, so those branches and links are based on README descriptions and are cited accordingly.

Main entry points: [`context/EngineContext.tsx`](https://github.com/kaos599/maglev/blob/main/context/EngineContext.tsx) (Engine context), [`app/add-download.tsx`](https://github.com/kaos599/maglev/blob/main/app/add-download.tsx) (Add transfer), [`app/browser.tsx`](https://github.com/kaos599/maglev/blob/main/app/browser.tsx) (Video browser), [`modules/maglev-engine/android/src/main/java/com/maglev/engine/EngineHost.kt`](https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/android/src/main/java/com/maglev/engine/EngineHost.kt) (Android engine host)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and intake"]
  node_browser["Video browser<br/>[browser.tsx]"]
  node_search["Torrent search<br/>[search.tsx]"]
  node_feeds["RSS feeds<br/>[feeds.tsx]"]
  node_shared["Shared links<br/>[add-torrent.tsx]"]
  node_intake["Add transfer<br/>[add-download.tsx]"]
end

subgraph group_transfer["Transfer management"]
  node_transfers["Transfers list<br/>[index.tsx]"]
  node_torrentdetail["Torrent detail<br/>[&#91;id&#93;.tsx]"]
  node_download_detail["Download detail<br/>[&#91;id&#93;.tsx]"]
end

subgraph group_engine["Engine and storage"]
  node_context["Engine context<br/>[EngineContext.tsx]"]
  node_bridge["Engine bridge"]
  node_host["Android engine host<br/>[EngineHost.kt]"]
  node_core["Torrent and HTTP core<br/>[engine.rs]"]
  node_storage["Android storage<br/>[StorageManager.kt]"]
end

subgraph group_support["Companion features"]
  node_subtitle["Subtitle search and save<br/>[flow.ts]"]
  node_subtitle_providers["Subtitle providers<br/>[search.ts]"]
  node_assistant["Download assistant<br/>[chatController.ts]"]
  node_assistant_ui["Assistant interface<br/>[assistant.tsx]"]
  node_browser_native["Browser protection"]
  node_feed_engine["Feed scheduler<br/>[FeedScheduler.kt]"]
end

node_user(("App user"))

node_user -->|"browses pages"| node_browser
node_user -->|"searches sources"| node_search
node_user -->|"follows feeds"| node_feeds
node_user -->|"shares link"| node_shared
node_browser -->|"adds found media"| node_intake
node_search -->|"adds result"| node_intake
node_feeds -.->|"configures auto-download"| node_feed_engine
node_feed_engine -.->|"starts torrents"| node_core
node_shared -.->|"submits source"| node_intake
node_intake -.->|"requests transfer"| node_context
node_transfers -->|"manages transfers"| node_context
node_torrentdetail -.->|"controls torrent"| node_context
node_download_detail -.->|"controls download"| node_context
node_context -->|"calls engine API"| node_bridge
node_bridge -.->|"invokes native module"| node_host
node_host -.->|"calls Rust core"| node_core
node_host -->|"uses storage management"| node_storage
node_user -->|"requests subtitles"| node_subtitle
node_subtitle -->|"searches providers"| node_subtitle_providers
node_subtitle -.->|"saves subtitle"| node_context
node_user -.->|"asks for help"| node_assistant_ui
node_assistant_ui -.->|"drives chat"| node_assistant
node_assistant -.->|"runs download tools"| node_context
node_browser -.->|"uses hardened browsing"| node_browser_native

click node_browser "https://github.com/kaos599/maglev/blob/main/app/browser.tsx"
click node_search "https://github.com/kaos599/maglev/blob/main/app/(tabs)/search.tsx"
click node_feeds "https://github.com/kaos599/maglev/blob/main/app/(tabs)/feeds.tsx"
click node_shared "https://github.com/kaos599/maglev/blob/main/app/add-torrent.tsx"
click node_intake "https://github.com/kaos599/maglev/blob/main/app/add-download.tsx"
click node_transfers "https://github.com/kaos599/maglev/blob/main/app/(tabs)/index.tsx"
click node_torrentdetail "https://github.com/kaos599/maglev/blob/main/app/torrent/%5Bid%5D.tsx"
click node_download_detail "https://github.com/kaos599/maglev/blob/main/app/download/%5Bid%5D.tsx"
click node_context "https://github.com/kaos599/maglev/blob/main/context/EngineContext.tsx"
click node_bridge "https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/src/MaglevNativeBridge.ts"
click node_host "https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/android/src/main/java/com/maglev/engine/EngineHost.kt"
click node_core "https://github.com/kaos599/maglev/blob/main/native/maglev-core/src/engine.rs"
click node_storage "https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/android/src/main/java/com/maglev/engine/storage/StorageManager.kt"
click node_subtitle "https://github.com/kaos599/maglev/blob/main/components/subtitles/flow.ts"
click node_subtitle_providers "https://github.com/kaos599/maglev/blob/main/utils/subtitles/search.ts"
click node_assistant "https://github.com/kaos599/maglev/blob/main/utils/assistantApp/chatController.ts"
click node_assistant_ui "https://github.com/kaos599/maglev/blob/main/app/(tabs)/assistant.tsx"
click node_browser_native "https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/android/src/main/java/com/maglev/engine/browser/BrowserHardening.kt"
click node_feed_engine "https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/android/src/main/java/com/maglev/engine/feeds/FeedScheduler.kt"

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_browser,node_search,node_feeds,node_shared,node_intake,node_user toneBlue
class node_transfers,node_torrentdetail,node_download_detail toneAmber
class node_context,node_bridge,node_host,node_core,node_storage toneMint
class node_subtitle,node_subtitle_providers,node_assistant,node_assistant_ui,node_browser_native,node_feed_engine toneRose
```

## Components

### Discovery and intake

- [Video browser](https://github.com/kaos599/maglev/blob/main/app/browser.tsx): `app/browser.tsx`
- [Torrent search](https://github.com/kaos599/maglev/blob/main/app/(tabs)/search.tsx): `app/(tabs)/search.tsx`
- [RSS feeds](https://github.com/kaos599/maglev/blob/main/app/(tabs)/feeds.tsx): `app/(tabs)/feeds.tsx`
- [Shared links](https://github.com/kaos599/maglev/blob/main/app/add-torrent.tsx): `app/add-torrent.tsx`
- [Add transfer](https://github.com/kaos599/maglev/blob/main/app/add-download.tsx): `app/add-download.tsx`

### Transfer management

- [Transfers list](https://github.com/kaos599/maglev/blob/main/app/(tabs)/index.tsx): `app/(tabs)/index.tsx`
- [Torrent detail](https://github.com/kaos599/maglev/blob/main/app/torrent/%5Bid%5D.tsx): `app/torrent/[id].tsx`
- [Download detail](https://github.com/kaos599/maglev/blob/main/app/download/%5Bid%5D.tsx): `app/download/[id].tsx`

### Engine and storage

- [Engine context](https://github.com/kaos599/maglev/blob/main/context/EngineContext.tsx): `context/EngineContext.tsx`
- [Engine bridge](https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/src/MaglevNativeBridge.ts): `modules/maglev-engine/src/MaglevNativeBridge.ts`
- [Android engine host](https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/android/src/main/java/com/maglev/engine/EngineHost.kt): `modules/maglev-engine/android/src/main/java/com/maglev/engine/EngineHost.kt`
- [Torrent and HTTP core](https://github.com/kaos599/maglev/blob/main/native/maglev-core/src/engine.rs): `native/maglev-core/src/engine.rs`
- [Android storage](https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/android/src/main/java/com/maglev/engine/storage/StorageManager.kt): `modules/maglev-engine/android/src/main/java/com/maglev/engine/storage/StorageManager.kt`

### Companion features

- [Subtitle search and save](https://github.com/kaos599/maglev/blob/main/components/subtitles/flow.ts): `components/subtitles/flow.ts`
- [Subtitle providers](https://github.com/kaos599/maglev/blob/main/utils/subtitles/search.ts): `utils/subtitles/search.ts`
- [Download assistant](https://github.com/kaos599/maglev/blob/main/utils/assistantApp/chatController.ts): `utils/assistantApp/chatController.ts`
- [Assistant interface](https://github.com/kaos599/maglev/blob/main/app/(tabs)/assistant.tsx): `app/(tabs)/assistant.tsx`
- [Browser protection](https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/android/src/main/java/com/maglev/engine/browser/BrowserHardening.kt): `modules/maglev-engine/android/src/main/java/com/maglev/engine/browser/BrowserHardening.kt`
- [Feed scheduler](https://github.com/kaos599/maglev/blob/main/modules/maglev-engine/android/src/main/java/com/maglev/engine/feeds/FeedScheduler.kt): `modules/maglev-engine/android/src/main/java/com/maglev/engine/feeds/FeedScheduler.kt`

### Other components

- **App user**

## Connections

- App user → Video browser: browses pages (evidence: `README.md`)
- App user → Torrent search: searches sources (evidence: `README.md`)
- App user → RSS feeds: follows feeds (evidence: `README.md`)
- App user → Shared links: shares link (evidence: `README.md`)
- Video browser → Add transfer: adds found media (evidence: `README.md`)
- Torrent search → Add transfer: adds result (evidence: `README.md`)
- RSS feeds → Feed scheduler: configures auto-download (evidence: `README.md`)
- Feed scheduler → Torrent and HTTP core: starts torrents (evidence: `README.md`)
- Shared links → Add transfer: submits source (evidence: `README.md`)
- Add transfer → Engine context: requests transfer
- Transfers list → Engine context: manages transfers (evidence: `app/(tabs)/index.tsx`)
- Torrent detail → Engine context: controls torrent
- Download detail → Engine context: controls download
- Engine context → Engine bridge: calls engine API (evidence: `context/EngineContext.tsx`)
- Engine bridge → Android engine host: invokes native module
- Android engine host → Torrent and HTTP core: calls Rust core
- Android engine host → Android storage: uses storage management (evidence: `modules/maglev-engine/android/src/main/java/com/maglev/engine/EngineHost.kt`)
- App user → Subtitle search and save: requests subtitles (evidence: `README.md`)
- Subtitle search and save → Subtitle providers: searches providers (evidence: `components/subtitles/flow.ts`)
- Subtitle search and save → Engine context: saves subtitle (evidence: `components/subtitles/flow.ts`)
- App user → Assistant interface: asks for help (evidence: `README.md`)
- Assistant interface → Download assistant: drives chat
- Download assistant → Engine context: runs download tools
- Video browser → Browser protection: uses hardened browsing (evidence: `README.md`)
