Magisk/README.MD

![](docs/images/logo.png)

[![Downloads](https://img.shields.io/badge/dynamic/json?color=green&label=Downloads&query=totalString&url=https%3A%2F%2Fraw.githubusercontent.com%2Ftopjohnwu%2Fmagisk-files%2Fcount%2Fcount.json&cacheSeconds=1800)](https://raw.githubusercontent.com/topjohnwu/magisk-files/count/count.json)

#### 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.<br>
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](https://github.com/topjohnwu/Magisk/) is the only source where you can get official Magisk information and downloads.

Click the icon below to download Magisk apk.

[![](https://img.shields.io/badge/Magisk-v27.0-blue)](https://github.com/topjohnwu/Magisk/releases/tag/v27.0)
[![](https://img.shields.io/badge/Magisk%20Beta-v28.0-blue)](https://github.com/topjohnwu/Magisk/releases/tag/v28.0)
[![](https://img.shields.io/badge/Magisk-Canary-red)](https://github.com/topjohnwu/Magisk/releases/tag/canary-28001)

## Useful Links

- [Installation Instruction](https://topjohnwu.github.io/Magisk/install.html)
- [Building and Development](https://topjohnwu.github.io/Magisk/build.html)
- [Magisk Documentation](https://topjohnwu.github.io/Magisk/)
- [Zygisk module sample](https://github.com/topjohnwu/zygisk-module-sample)

## Bug Reports

**Only bug reports from 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 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/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/>.
Update documentation 2020-03-23 11:24:20 +00:00			`![](docs/images/logo.png)`
Update README 2018-10-05 21:52:40 +00:00
Update README 2021-03-07 12:12:32 +00:00			`[![Downloads](https://img.shields.io/badge/dynamic/json?color=green&label=Downloads&query=totalString&url=https%3A%2F%2Fraw.githubusercontent.com%2Ftopjohnwu%2Fmagisk-files%2Fcount%2Fcount.json&cacheSeconds=1800)](https://raw.githubusercontent.com/topjohnwu/magisk-files/count/count.json)`
Add live download counts 2020-03-25 11:00:21 +00:00
Update README 2021-08-28 17:45:32 +00:00			`#### This is not an officially supported Google product`

Update README 2018-10-05 21:52:40 +00:00			`## Introduction`
Misc Formatting * PEP8 and linting * empty exceptions 2019-02-11 08:18:15 +00:00
Clean up more codes 2023-03-17 12:08:31 +00:00			`Magisk is a suite of open source software for customizing Android, supporting devices higher than Android 6.0.<br>`
Update README 2021-08-28 17:45:32 +00:00			`Some highlight features:`
Update README 2018-10-05 21:52:40 +00:00
Remove more pre SDK 21 stuffs 2021-04-10 04:29:42 +00:00			`- MagiskSU: Provide root access for applications`
Update documentation 2020-03-23 11:24:20 +00:00			`- Magisk Modules: Modify read-only partitions by installing modules`
Remove more pre SDK 21 stuffs 2021-04-10 04:29:42 +00:00			`- MagiskBoot: The most complete tool for unpacking and repacking Android boot images`
Update README 2022-01-26 10:33:22 +00:00			`- Zygisk: Run code in every Android applications' processes`
Misc Formatting * PEP8 and linting * empty exceptions 2019-02-11 08:18:15 +00:00
Update README Recommend Android Studio embedded JDK again 2020-07-02 11:16:02 +00:00			`## Downloads`
Update README 2020-03-13 09:12:35 +00:00
Remove more pre SDK 21 stuffs 2021-04-10 04:29:42 +00:00			`[Github](https://github.com/topjohnwu/Magisk/) is the only source where you can get official Magisk information and downloads.`
[README] Warn users that the official website is github Google puts a number of cheeky looking websites in the results for Magisk. I only found out they were unofficial is though issue #3435. This deserves to be shown more prominently. 2021-01-30 06:08:07 +00:00
Update README.MD (#8192) Co-authored-by: 南宫雪珊 <vvb2060@gmail.com> 2024-07-08 19:02:14 +00:00			`Click the icon below to download Magisk apk.`

Update README 2024-02-07 22:39:53 +00:00			`[![](https://img.shields.io/badge/Magisk-v27.0-blue)](https://github.com/topjohnwu/Magisk/releases/tag/v27.0)`
Release Magisk v28.0 2024-10-10 08:47:00 +00:00			`[![](https://img.shields.io/badge/Magisk%20Beta-v28.0-blue)](https://github.com/topjohnwu/Magisk/releases/tag/v28.0)`
Release new canary build 2024-10-10 09:10:50 +00:00			`[![](https://img.shields.io/badge/Magisk-Canary-red)](https://github.com/topjohnwu/Magisk/releases/tag/canary-28001)`
Update build.sh 2016-11-08 21:16:03 +00:00
Update documentation 2020-03-23 11:24:20 +00:00			`## Useful Links`
Misc Formatting * PEP8 and linting * empty exceptions 2019-02-11 08:18:15 +00:00
Update documentation 2020-03-23 11:24:20 +00:00			`- [Installation Instruction](https://topjohnwu.github.io/Magisk/install.html)`
Update development docs 2023-05-13 09:37:52 +00:00			`- [Building and Development](https://topjohnwu.github.io/Magisk/build.html)`
Update README 2020-10-03 11:28:43 +00:00			`- [Magisk Documentation](https://topjohnwu.github.io/Magisk/)`
Update README.MD (#8192) Co-authored-by: 南宫雪珊 <vvb2060@gmail.com> 2024-07-08 19:02:14 +00:00			`- [Zygisk module sample](https://github.com/topjohnwu/zygisk-module-sample)`

Update documentation 2020-03-23 11:24:20 +00:00			`## Bug Reports`

Release new canary build 2022-05-15 08:14:07 +00:00			`Only bug reports from Debug builds will be accepted.`
Update documentation 2020-03-23 11:24:20 +00:00
			`For installation issues, upload both boot image and install logs.<br>`
			`For Magisk issues, upload boot logcat or dmesg.<br>`
Update README 2021-02-23 12:22:32 +00:00			`For Magisk app crashes, record and upload the logcat when the crash occurs.`
Update README.md 2019-03-08 15:23:42 +00:00
Update documentation 2020-03-23 11:24:20 +00:00			`## Translation Contributions`
Update README.md 2019-03-08 15:23:42 +00:00
Update README 2021-02-23 12:22:32 +00:00			`Default string resources for the Magisk app and its stub APK are located here:`
Update README.md 2019-03-08 15:23:42 +00:00
Update README.MD (#8192) Co-authored-by: 南宫雪珊 <vvb2060@gmail.com> 2024-07-08 19:02:14 +00:00			- `app/core/src/main/res/values/strings.xml`
			- `app/stub/src/main/res/values/strings.xml`
Update README.md 2019-03-08 15:23:42 +00:00
Reorganize string resources 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`).
Update README.MD 2018-09-09 16:25:22 +00:00
Update README.MD 2017-06-03 18:49:24 +00:00			`## License`
Use GPL v3 license and update copyright messages 2017-04-22 09:08:47 +00:00
Misc Formatting * PEP8 and linting * empty exceptions 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.`
Use GPL v3 license and update copyright messages 2017-04-22 09:08:47 +00:00
Misc Formatting * PEP8 and linting * empty exceptions 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.`
Use GPL v3 license and update copyright messages 2017-04-22 09:08:47 +00:00
Misc Formatting * PEP8 and linting * empty exceptions 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/>.`