How kaos599/maglev works
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: EngineContext.tsx Engine context · add-download.tsx Add transfer · browser.tsx Video browser · EngineHost.kt Android engine host
Components 20
Discovery and intake
- Video browser
app/browser.tsx - Torrent search
app/(tabs)/search.tsx - RSS feeds
app/(tabs)/feeds.tsx - Shared links
app/add-torrent.tsx - Add transfer
app/add-download.tsx
Transfer management
- Transfers list
app/(tabs)/index.tsx - Torrent detail
app/torrent/[id].tsx - Download detail
app/download/[id].tsx
Engine and storage
- Engine context
context/EngineContext.tsx - Engine bridge
modules/maglev-engine/src/MaglevNativeBridge.ts - Android engine host
modules/maglev-engine/android/src/main/java/com/maglev/engine/EngineHost.kt - Torrent and HTTP core
native/maglev-core/src/engine.rs - Android storage
modules/maglev-engine/android/src/main/java/com/maglev/engine/storage/StorageManager.kt
Companion features
- Subtitle search and save
components/subtitles/flow.ts - Subtitle providers
utils/subtitles/search.ts - Download assistant
utils/assistantApp/chatController.ts - Assistant interface
app/(tabs)/assistant.tsx - Browser protection
modules/maglev-engine/android/src/main/java/com/maglev/engine/browser/BrowserHardening.kt - Feed scheduler
modules/maglev-engine/android/src/main/java/com/maglev/engine/feeds/FeedScheduler.kt
Other components
- App user
Connections 24
- App user → Video browser: browses pages
README.md - App user → Torrent search: searches sources
README.md - App user → RSS feeds: follows feeds
README.md - App user → Shared links: shares link
README.md - Video browser → Add transfer: adds found media
README.md - Torrent search → Add transfer: adds result
README.md - RSS feeds → Feed scheduler: configures auto-download
README.md - Feed scheduler → Torrent and HTTP core: starts torrents
README.md - Shared links → Add transfer: submits source
README.md - Add transfer → Engine context: requests transfer
- Transfers list → Engine context: manages transfers
app/(tabs)/index.tsx - Torrent detail → Engine context: controls torrent
- Download detail → Engine context: controls download
- Engine context → Engine bridge: calls engine API
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
modules/maglev-engine/android/src/main/java/com/maglev/engine/EngineHost.kt - App user → Subtitle search and save: requests subtitles
README.md - Subtitle search and save → Subtitle providers: searches providers
components/subtitles/flow.ts - Subtitle search and save → Engine context: saves subtitle
components/subtitles/flow.ts - App user → Assistant interface: asks for help
README.md - Assistant interface → Download assistant: drives chat
- Download assistant → Engine context: runs download tools
- Video browser → Browser protection: uses hardened browsing
README.md