Overview
Magisk Manager for Recovery Mode (mm), originally conceived by VR25 and comprehensively modernized and maintained by Rikj000, is a critical rescue tool for Android power users and module developers. When an incompatible module causes a bootloop, Android cannot reach the graphical Magisk Manager application to allow disabling the offending package.
mm solves this dilemma by providing a complete, interactive module management environment directly inside custom recoveries like TWRP, OrangeFox, and PitchBlack Recovery Project (PBRP). Through a simple terminal command, users can enumerate installed modules, toggle disable flags, or completely remove faulty files without needing to perform a factory reset.
Prerequisites & Compatibility
- Magisk Version: Broad compatibility covering Magisk v19.0 through v30.X.
- Recovery Environment: Any custom recovery featuring an interactive terminal console or accessible via
adb shellfrom a computer. - Storage Requirement: Installation packages should be stored on internal device storage rather than external SD cards for consistent recovery mounting.
There are no documented module conflicts; mm operates strictly as a maintenance and diagnostic utility.
Installation & Deployment
mm can be acquired and flashed through several channels:
- Magisk Manager / MRepo / MMRL: Download and install
Magisk Manager for Recovery Mode (mm)via the Magisk app or community managers like MMRL. - Custom Recovery Flashing: Alternatively, flash the
MagiskManagerForRecovery_v*.zipfile directly from TWRP recovery. - The installation automatically establishes the terminal runner script at
/sdcard/mm.
Usage & Terminal Commands
When experiencing a bootloop or needing to manage modules outside Android:
- Boot your device into your custom recovery (e.g., TWRP).
- Ensure the
/datapartition is mounted and decrypted. - Open the Advanced > Terminal menu in your recovery interface (or launch
adb shellfrom a connected PC). - Run either of the following commands:
*/mm # or sh /sdcard/mm - An interactive menu will appear on screen:
- List installed modules: Displays all active modules in
/data/adb/modules/along with their enabled/disabled status. - Toggle Module State: Enter the number corresponding to a module to disable or re-enable it.
- Remove Module: Delete the module folder entirely from
/data/adb/modules/. - Toggle Core-Only Mode: Force Magisk to load only core binaries and skip all modules on the subsequent boot.
- List installed modules: Displays all active modules in
Troubleshooting & Tips
- Terminal Reports File Not Found: If executing
sh /sdcard/mmreturns an error, verify that the/dataand internal storage partitions are properly mounted and decrypted within your recovery’s Mount menu. - Module Disabled But Still Loops: Some modules modify persistent vendor properties or system settings. If disabling individual modules does not resolve the bootloop, use
mmto enable Core-Only Mode, reboot into Android, and cleanly uninstall residual companion apps.
