How zenyxx-xd/rootmyvivo works
RootMyVivo is an Android app that temporarily roots supported locked-bootloader vivo/iQOO devices with a kernel-matched GhostLock payload, then installs a chosen KernelSU manager. The main path runs from the user through the Compose UI and ViewModel into catalog matching, payload execution and KernelSU installation, using Shizuku/ADB or root shell transport. Separate branches cover boot-time root recovery, device/catalog discovery, logs, settings and in-app updates. Edges reflect excerpts, SOURCE INDEX references or README statements; unsampled implementation details are not inferred.
Main entry points: MainViewModel.kt Main ViewModel · ExploitEngine.kt Exploit engine · Transport.kt Shell transport · App.kt Navigation UI
Components 26
App UI
- Main activity
app/src/main/java/com/rootmyvivo/MainActivity.kt - Navigation UI
app/src/main/java/com/rootmyvivo/ui/App.kt - Home and device screens
app/src/main/java/com/rootmyvivo/ui/home - Root flow screen
app/src/main/java/com/rootmyvivo/ui/flow - Settings and logs
app/src/main/java/com/rootmyvivo/ui
App orchestration
- Main ViewModel
app/src/main/java/com/rootmyvivo/vm/MainViewModel.kt - App state
app/src/main/java/com/rootmyvivo/vm/AppState.kt
Root workflow
- Exploit engine
app/src/main/java/com/rootmyvivo/root/ExploitEngine.kt - Local runner
app/src/main/java/com/rootmyvivo/root/LocalRunner.kt - KernelSU installer
app/src/main/java/com/rootmyvivo/root/KsuInstaller.kt - KernelSU variants
app/src/main/java/com/rootmyvivo/root/KsuVariant.kt - Root reports
app/src/main/java/com/rootmyvivo/data/RootReport.kt - Root traces
app/src/main/java/com/rootmyvivo/root/RootTraces.kt
Data and access
- Payload catalog
app/src/main/java/com/rootmyvivo/data/Catalog.kt - Device detection
app/src/main/java/com/rootmyvivo/data/Device.kt - Preferences
app/src/main/java/com/rootmyvivo/data/Prefs.kt - App updater
app/src/main/java/com/rootmyvivo/data/AppUpdater.kt - Shell transport
app/src/main/java/com/rootmyvivo/shell/Transport.kt - ADB wire protocol
app/src/main/java/com/rootmyvivo/shell/AdbWire.kt
Boot recovery
- Boot receiver
app/src/main/java/com/rootmyvivo/BootReceiver.kt - Boot root service
app/src/main/java/com/rootmyvivo/BootRootService.kt - Foreground service
app/src/main/java/com/rootmyvivo/ExploitService.kt
Other components
- Device owner
- Shizuku / ADB
- Payload catalog host
- Download hosts
Connections 34
- Device owner → Main activity: opens
README.md - Shizuku / ADB → Shell transport: provides shell
README.md - Main activity → Main ViewModel: creates
app/src/main/java/com/rootmyvivo/MainActivity.kt - Main activity → Navigation UI: renders
app/src/main/java/com/rootmyvivo/MainActivity.kt - Navigation UI → Home and device screens: routes to
app/src/main/java/com/rootmyvivo/ui/App.kt - Navigation UI → Root flow screen: routes to
app/src/main/java/com/rootmyvivo/ui/App.kt - Navigation UI → Settings and logs: routes to
app/src/main/java/com/rootmyvivo/ui/App.kt - Navigation UI → Main ViewModel: uses state
app/src/main/java/com/rootmyvivo/ui/App.kt - Home and device screens → Main ViewModel: invokes actions
app/src/main/java/com/rootmyvivo/ui/home/HomeScreen.kt - Main ViewModel → App state: updates
app/src/main/java/com/rootmyvivo/vm/MainViewModel.kt - Main ViewModel → Payload catalog: fetches and matches
app/src/main/java/com/rootmyvivo/vm/MainViewModel.kt - Payload catalog → Payload catalog host: fetches catalog
README.md - Main ViewModel → Device detection: detects device
- Main ViewModel → Exploit engine: starts root
app/src/main/java/com/rootmyvivo/vm/MainViewModel.kt - Exploit engine → Payload catalog: selects payload
app/src/main/java/com/rootmyvivo/root/ExploitEngine.kt - Exploit engine → Local runner: runs payload
app/src/main/java/com/rootmyvivo/root/ExploitEngine.kt - Exploit engine → KernelSU installer: installs manager
app/src/main/java/com/rootmyvivo/root/ExploitEngine.kt - Exploit engine → Shell transport: checks root
app/src/main/java/com/rootmyvivo/root/ExploitEngine.kt - Exploit engine → Root reports: creates proof
app/src/main/java/com/rootmyvivo/root/ExploitEngine.kt - Exploit engine → Root traces: records traces
app/src/main/java/com/rootmyvivo/root/ExploitEngine.kt - KernelSU installer → Shell transport: executes root commands
app/src/main/java/com/rootmyvivo/root/KsuInstaller.kt - KernelSU installer → Local runner: runs local commands
app/src/main/java/com/rootmyvivo/root/KsuInstaller.kt - KernelSU installer → KernelSU variants: uses variant
app/src/main/java/com/rootmyvivo/root/KsuInstaller.kt - KernelSU installer → Download hosts: downloads manager files
- Main ViewModel → App updater: checks updates
app/src/main/java/com/rootmyvivo/vm/MainViewModel.kt - Main ViewModel → Shell transport: refreshes transport
app/src/main/java/com/rootmyvivo/vm/MainViewModel.kt - Shell transport → ADB wire protocol: sends shell commands
app/src/main/java/com/rootmyvivo/shell/Transport.kt - Shell transport → Preferences: reads settings
app/src/main/java/com/rootmyvivo/shell/Transport.kt - Main ViewModel → Preferences: stores preferences
app/src/main/java/com/rootmyvivo/vm/MainViewModel.kt - Boot receiver → Boot root service: starts on boot
app/src/main/java/com/rootmyvivo/BootReceiver.kt - Boot root service → Preferences: checks recovery setting
app/src/main/java/com/rootmyvivo/BootRootService.kt - Boot root service → Local runner: relaunches payload
app/src/main/java/com/rootmyvivo/BootRootService.kt - Boot root service → Shell transport: checks root transport
app/src/main/java/com/rootmyvivo/BootRootService.kt - Main ViewModel → Foreground service: keeps flow active
app/src/main/java/com/rootmyvivo/vm/MainViewModel.kt