About this project

Magisk is a suite of open source software for customizing Android devices running Android 6.0 or higher. It is the most widely adopted solution for managing root access on Android. ## Key Components **MagiskSU** — Provides root access for applications. Unlike traditional root solutions, Magisk implements a systemless root approach, meaning it does not modify the read-only /system partition. Instead, it mounts a magisk folder at /sbin and overlays changes at runtime. **Magisk Modules** — Allow users to modify read-only partitions by installing self-contained packages. Modules are placed in /data/adb/modules and are applied during boot, enabling both system modifications and persistent customizations without touching the stock system image. **MagiskBoot** — A comprehensive command-line utility for unpacking, modifying, and repacking Android boot images, recovery images, and other boot-related formats. It is considered one of the most complete tools for these operations. **Zygisk** — An injection framework that runs code inside the processes of every Android application by hooking into the Zygote process. It replaces the older DenyList mechanism and enables module-level hooks across all apps. ## Installation Official installation instructions are available at topjohnwu.github.io/Magisk/install.html. The primary download source is the official GitHub releases page. ## Building Build and development documentation can be found at topjohnwu.github.io/Magisk/build.html. ## Bug Reporting The project accepts bug reports exclusively from Debug builds. Users are asked to include relevant logs depending on the issue type: - Installation issues: boot image and install logs - General Magisk issues: boot logcat or dmesg output - App crashes: full logcat recorded at the time of the crash ## Translation Contributions Default string resources are located in: - `app/core/src/main/res/values/strings.xml` - `app/stub-res/src/main/res/values/strings.xml` Translators should place localized strings in the corresponding `[module]/src/main/res/values-[lang]/strings.xml` directories. ## License Magisk is licensed under the GNU General Public License version 3 or later.