2020-03-23 11:24:20 +00:00
2018-10-05 21:52:40 +00:00
## Introduction
2019-02-11 08:18:15 +00:00
2020-03-23 11:24:20 +00:00
Magisk is a suite of open source tools for customizing Android, supporting devices higher than Android 4.2. It covers fundamental parts of Android customization: root, boot scripts, SELinux patches, AVB2.0 / dm-verity / forceencrypt removals etc.
2018-10-05 21:52:40 +00:00
2020-03-23 11:24:20 +00:00
Here are some feature highlights:
2018-10-05 21:52:40 +00:00
2020-03-23 11:24:20 +00:00
- **MagiskSU**: Provide root access to your device
- **Magisk Modules**: Modify read-only partitions by installing modules
- **MagiskHide**: Hide Magisk from root detections / system integrity checks
2019-02-11 08:18:15 +00:00
2020-03-23 11:24:20 +00:00
## Download
2020-03-13 09:12:35 +00:00
2020-03-23 11:24:20 +00:00
[](https://github.com/topjohnwu/Magisk/releases/download/manager-v7.5.1/MagiskManager-v7.5.1.apk)
[](https://github.com/topjohnwu/Magisk/releases/download/v20.3/Magisk-v20.3.zip)
[](https://github.com/topjohnwu/Magisk/releases/download/v20.4/Magisk-v20.4.zip)
<br>
[](https://raw.githubusercontent.com/topjohnwu/magisk_files/canary/app-release.apk)
[](https://raw.githubusercontent.com/topjohnwu/magisk_files/canary/app-debug.apk)
2016-11-08 21:16:03 +00:00
2020-03-23 11:24:20 +00:00
## Useful Links
2019-02-11 08:18:15 +00:00
2020-03-23 11:24:20 +00:00
- [Installation Instruction](https://topjohnwu.github.io/Magisk/install.html)
- [OTA Upgrade Guide](https://topjohnwu.github.io/Magisk/ota.html)
- [Full Official Docs](https://topjohnwu.github.io/Magisk/)
- [Magisk Troubleshoot Wiki](https://www.didgeridoohan.com/magisk/HomePage) (by [@Didgeridoohan](https://github.com/Didgeridoohan))
2017-06-03 18:49:24 +00:00
2020-03-23 11:24:20 +00:00
## Android Version Support
2019-02-11 08:18:15 +00:00
2020-03-23 11:24:20 +00:00
- Android 4.2+: MagiskSU and Magisk Modules Only
- Android 4.4+: All core features available
- Android 6.0+: Guaranteed MagiskHide support
- Android 7.0+: Full MagiskHide protection
- Android 9.0+: Magisk Manager stealth mode
## Bug Reports
Canary Channels are cutting edge builds for those adventurous. To access canary builds, install either Canary Magisk Manager, switch to a Canary Channel in settings and upgrade.
**Only bug reports from Canary DEBUG builds will be accepted.**
For installation issues, upload both boot image and install logs.<br>
For Magisk issues, upload boot logcat or dmesg.<br>
For Magisk Manager crashes, record and upload the logcat when the crash occurs.
2019-03-08 15:23:42 +00:00
2020-03-23 11:24:20 +00:00
## Building Magisk
- Clone sources: `git clone --recurse-submodules https://github.com/topjohnwu/Magisk.git`
- Magisk builds on any OS Android Studio supports. Install Android Studio and import the project.
- Python 3.6+. For Windows only, install Colorama with `pip install colorama` in admin shell.
- Use the JDK bundled in Android Studio:
- macOS: `export JAVA_HOME="/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home"`
- Linux: `export PATH="/path/to/androidstudio/jre/bin:$PATH"`
- Windows: Add `C:\Path\To\Android Studio\jre\bin` to environment variable `PATH`
2020-03-23 11:45:06 +00:00
- Set environment variable `ANDROID_HOME` to the Android SDK folder
2020-03-23 11:24:20 +00:00
- Download / clone [FrankeNDK](https://github.com/topjohnwu/FrankeNDK) and set environment variable `ANDROID_NDK_HOME` to the folder
2020-03-23 11:45:06 +00:00
- Set configurations in `config.prop`. A sample file `config.prop.sample` is provided.
- Run `build.py` to see help messages. For each supported actions, use `-h` to access help (e.g. `./build.py all -h`)
- By default, the script builds everything in debug mode. If you want to build Magisk Manager in release mode (with the `-r, --release` flag), you need a Java Keystore (only `JKS` format is supported) to sign APKs and zips. For more information, check [Google's Documentation](https://developer.android.com/studio/publish/app-signing.html#generate-key).
2020-03-23 11:24:20 +00:00
## Translation Contributions
2019-03-08 15:23:42 +00:00
2019-10-15 07:33:22 +00:00
Default string resources for Magisk Manager and its stub APK are located here:
2019-03-08 15:23:42 +00:00
- `app/src/main/res/values/strings.xml`
2019-10-15 07:33:22 +00:00
- `stub/src/main/res/values/strings.xml`
2019-03-08 15:23:42 +00:00
2019-10-15 07:33:22 +00:00
Translate each and place them in the respective locations (`[module]/src/main/res/values-[lang]/strings.xml`).
2018-09-09 16:25:22 +00:00
2017-06-03 18:49:24 +00:00
## License
2017-04-22 09:08:47 +00:00
2019-02-11 08:18:15 +00:00
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.
2017-04-22 09:08:47 +00:00
2019-02-11 08:18:15 +00:00
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.
2017-04-22 09:08:47 +00:00
2019-02-11 08:18:15 +00:00
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
