The Magic Mask for Android
  • Kotlin 44%
  • Rust 27.5%
  • C++ 16.6%
  • Java 6.3%
  • Shell 3.2%
  • Other 2.4%
Find a file
lsx 0675a18a3a init: check charger mode before force_normal_boot
b55f597c ("Skip loading magisk in charger mode") aborts when
androidboot.mode=charger, but the check sits after the force_normal_boot
branch. Devices that set androidboot.force_normal_boot=1 during off-mode
charging (e.g. some Motorola models) take force_normal_boot -> first_stage()
and never reach the charger check, so Magisk still loads in charger mode and
bumps the never-reset bootloop counter until safe mode trips.

Move the charger check ahead of skip_initramfs/force_normal_boot so charger
boots abort regardless, matching AOSP treating charger mode first.

Fixes #9967.
2026-08-18 18:38:55 +00:00
.github Handle empty matrix.type correctly 2026-08-11 01:20:15 +00:00
app app: reset install method when file picker or download dialog is cancelled 2026-08-18 10:57:09 -07:00
docs Update Samsung download mode documentation 2026-04-14 03:25:38 -07:00
native init: check charger mode before force_normal_boot 2026-08-18 18:38:55 +00:00
scripts Update live_setup.sh 2026-08-18 17:56:10 +00:00
tools Use Rust elf-cleaner implementation 2025-04-01 18:32:54 -07:00
.gitattributes Use Rust elf-cleaner implementation 2025-04-01 18:32:54 -07:00
.gitignore remove unused code 2026-07-28 20:10:20 -07:00
.gitmodules Use lzma-rust2 for xz and lzma compression and decompression 2025-08-24 00:23:55 -07:00
AGENTS.md docs: update AGENTS.md in subdirectories 2026-08-18 17:56:10 +00:00
build.py Fix compilation database generation when sccache is enabled 2026-04-20 01:17:00 -07:00
config.prop.sample Support setting custom ABI list 2024-08-01 14:33:08 -07:00
LICENSE Use GPL v3 license and update copyright messages 2017-04-22 17:12:54 +08:00
README.MD Move stub resources into its own module 2026-04-08 05:29:57 +00:00

Downloads

This is not an officially supported Google product

Introduction

Magisk is a suite of open source software for customizing Android, supporting devices higher than Android 6.0.
Some highlight features:

  • MagiskSU: Provide root access for applications
  • Magisk Modules: Modify read-only partitions by installing modules
  • MagiskBoot: The most complete tool for unpacking and repacking Android boot images
  • Zygisk: Run code in every Android applications' processes

Downloads

Github is the only source where you can get official Magisk information and downloads.

Bug Reports

Only bug reports from Debug builds will be accepted.

For installation issues, upload both boot image and install logs.
For Magisk issues, upload boot logcat or dmesg.
For Magisk app crashes, record and upload the logcat when the crash occurs.

Translation Contributions

Default string resources for the Magisk app and its stub APK are located here:

  • app/core/src/main/res/values/strings.xml
  • app/stub-res/src/main/res/values/strings.xml

Translate each and place them in the respective locations ([module]/src/main/res/values-[lang]/strings.xml).

License

Magisk, including all git submodules are free software:
you can redistribute it and/or modify it under the terms of the
GNU General Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.