How topjohnwu/magisk works
Magisk is an Android root-management suite. The principal workflow is: a user opens the manager, selects an update or module, the app schedules or starts a download, fetches it from a release source, processes it, and presents progress or completion. The broader product also manages superuser policy, DenyList behavior, module flashing, boot-image patching, and Zygisk injection. The graph combines README capabilities with sampled implementation; several UI-to-native links remain intentionally conservative.
Main entry points: DownloadEngine.kt Download Engine · MainActivity.kt Main Activity · mod.rs MagiskSU · daemon.rs Magisk Daemon
Components 22
Manager UI
- Main Activity
app/apk/src/main/java/com/topjohnwu/magisk/ui/MainActivity.kt - Main Screen
app/apk/src/main/java/com/topjohnwu/magisk/ui/MainScreen.kt - Module Screen
app/apk/src/main/java/com/topjohnwu/magisk/ui/module/ModuleScreen.kt - Superuser Screen
app/apk/src/main/java/com/topjohnwu/magisk/ui/superuser/SuperuserScreen.kt - Install Dialog
app/apk-legacy/src/main/java/com/topjohnwu/magisk/dialog/ManagerInstallDialog.kt
App Services
- Download Engine
app/core/src/main/java/com/topjohnwu/magisk/core/download/DownloadEngine.kt - Job Service
app/core/src/main/java/com/topjohnwu/magisk/core/JobService.kt - Download Processor
app/core/src/main/java/com/topjohnwu/magisk/core/download/DownloadProcessor.kt - Network Service
app/core/src/main/java/com/topjohnwu/magisk/core/repository/NetworkService.kt - Policy Database
app/core/src/main/java/com/topjohnwu/magisk/core/data/magiskdb/MagiskDB.kt
Native Runtime
- Magisk Daemon
native/src/core/daemon.rs - MagiskSU
native/src/core/su/mod.rs - DenyList
native/src/core/deny/deny.hpp - Zygisk
native/src/core/zygisk/mod.rs
Boot Modules
- Flash Zip
app/core/src/main/java/com/topjohnwu/magisk/core/tasks/FlashZip.kt - MagiskBoot
native/src/boot/lib.rs
APK Loading
- Stub Loader
app/stub/src/main/java/com/topjohnwu/magisk/DynLoad.java
Other components
- Android User
- Android Apps
- Android OS
- Release Sources
- Boot Image
Connections 21
- Android User → Main Activity: opens
- Main Activity → Main Screen: renders
- Android User → Install Dialog: confirms install
- Install Dialog → Download Engine: starts download
- Android OS → Job Service: dispatches jobs
- Job Service → Download Engine: starts download
- Download Engine → Network Service: fetches file
- Network Service → Release Sources: requests releases
- Download Engine → Download Processor: processes stream
- Download Engine → Android OS: updates notifications
- Android User → Module Screen: manages modules
- Module Screen → Flash Zip: starts flashing
- Flash Zip → MagiskBoot: patches images
- MagiskBoot → Boot Image: unpacks repacks
- Android Apps → MagiskSU: requests root
- MagiskSU → Policy Database: reads policies
- Superuser Screen → Policy Database: manages policies
- Magisk Daemon → MagiskSU: serves requests
- Magisk Daemon → DenyList: enforces hiding
- Zygisk → Android Apps: injects code
- Stub Loader → Main Activity: loads app