2021-01-29 00:22:15 +08:00
# LSPosed Framework
2019-10-21 23:39:08 +08:00
2024-07-24 10:10:47 +02:00
[](https://github.com/JingMatrix/LSPosed/actions/workflows/core.yml?query=event%3Apush+branch%3Amaster+is%3Acompleted) [](https://crowdin.com/project/lsposed_jingmatrix) [](https://github.com/JingMatrix/LSPosed/releases/latest) [](https://github.com/JingMatrix/LSPosed/releases)
2019-01-19 01:54:14 +08:00
2019-12-19 17:42:04 +08:00
## Introduction
2019-01-19 01:54:14 +08:00
2024-09-23 07:29:11 +02:00
A Zygisk module trying to provide an ART hooking framework which delivers consistent APIs with the OG Xposed, leveraging LSPlant hooking framework.
2019-03-15 20:18:26 +08:00
2021-12-09 00:32:15 +08:00
> Xposed is a framework for modules that can change the behavior of the system and apps without touching any APKs. That's great because it means that modules can work for different versions and even ROMs without any changes (as long as the original code was not changed too much). It's also easy to undo. As all changes are done in the memory, you just need to deactivate the module and reboot to get your original system back. There are many other advantages, but here is just one more: multiple modules can do changes to the same part of the system or app. With modified APKs, you have to choose one. No way to combine them, unless the author builds multiple APKs with different combinations.
2019-12-19 17:42:04 +08:00
## Supported Versions
2025-07-12 11:30:46 +02:00
Android 8.1 ~ 16
2019-01-19 01:54:14 +08:00
2019-01-22 20:50:06 +08:00
## Install
2024-09-23 07:08:26 +02:00
1. Install Magisk v26+
2. [Download ](#download ) and install LSPosed in Magisk app
3. Reboot
4. Open LSPosed manager from notification
5. Have fun :)
2019-01-22 20:50:06 +08:00
2019-12-19 17:42:04 +08:00
## Download
2024-07-23 22:10:42 +02:00
- For stable releases, please go to [Github Releases page ](https://github.com/JingMatrix/LSPosed/releases )
- For canary build, please check [Github Actions ](https://github.com/JingMatrix/LSPosed/actions/workflows/core.yml?query=branch%3Amaster )
2023-01-15 16:26:42 +08:00
2021-12-09 00:32:15 +08:00
Note: debug builds are only available in Github Actions.
2019-05-01 20:04:13 +08:00
2019-12-19 17:42:04 +08:00
## Get Help
2023-01-15 16:26:42 +08:00
**Only bug reports from **THE LATEST DEBUG BUILD ** will be accepted.**
2024-07-23 22:10:42 +02:00
- GitHub issues: [Issues ](https://github.com/JingMatrix/LSPosed/issues/ )
2021-02-20 19:02:20 +08:00
- (For Chinese speakers) 本项目只接受英语**标题**的issue。如果您不懂英语， 翻译工具 ](https://www.deepl.com/zh/translator )
2019-12-19 17:42:04 +08:00
2020-12-21 23:07:28 +08:00
## For Developers
2019-05-01 20:04:13 +08:00
2021-12-09 00:32:15 +08:00
Developers are welcome to write Xposed modules with hooks based on LSPosed Framework. A module based on LSPosed framework is fully compatible with the original Xposed Framework, and vice versa, a Xposed Framework-based module will work well with LSPosed framework too.
2019-05-01 20:04:13 +08:00
2019-12-19 17:42:04 +08:00
- [Xposed Framework API ](https://api.xposed.info/ )
2019-01-22 20:50:06 +08:00
2021-02-28 23:59:34 +08:00
We use our own module repository. We welcome developers to submit modules to our repository, and then modules can be downloaded in LSPosed.
2019-01-22 20:50:49 +08:00
2021-02-28 23:59:34 +08:00
- [LSPosed Module Repository ](https://github.com/Xposed-Modules-Repo )
2019-07-05 16:35:17 +08:00
2019-12-19 17:42:04 +08:00
## Community Discussion
2019-07-05 15:57:57 +08:00
2025-07-12 11:30:46 +02:00
[Troubleshooting guide ](https://github.com/JingMatrix/LSPosed/issues/123 ) and [Disscusions ](https://github.com/JingMatrix/LSPosed/discussions ).
2019-07-05 16:35:17 +08:00
2024-07-24 10:10:47 +02:00
## Translation Contributing
2021-09-08 10:11:08 +08:00
2024-07-24 10:10:47 +02:00
You can contribute translation [here ](https://crowdin.com/project/lsposed_jingmatrix ).
2021-09-08 10:11:08 +08:00
2019-05-01 20:04:13 +08:00
## Credits
- [Magisk ](https://github.com/topjohnwu/Magisk/ ): makes all these possible
2021-12-09 00:32:15 +08:00
- [XposedBridge ](https://github.com/rovo89/XposedBridge ): the OG Xposed framework APIs
2024-07-23 22:10:42 +02:00
- [LSPlant ](https://github.com/JingMatrix/LSPlant ): the core ART hooking framework
2024-12-04 11:55:28 +01:00
- [Dobby ](https://github.com/JingMatrix/Dobby ): inline hooker for `LSPlant` and `native_api` implement
2021-01-29 08:21:04 +08:00
- [EdXposed ](https://github.com/ElderDrivers/EdXposed ): fork source
2024-09-03 13:33:23 +02:00
- [xz-embedded ](https://github.com/tukaani-project/xz-embedded ): decompress `.gnu_debugdata` header section of stripped `libart.so`
2024-09-23 07:29:11 +02:00
- ~~[Riru ](https://github.com/RikkaApps/Riru ): provides a way to inject code into zygote process~~
2021-03-08 23:20:53 +08:00
- ~[SandHook ](https://github.com/ganyao114/SandHook/ ): ART hooking framework for SandHook variant~
2022-03-15 21:18:02 +08:00
- ~[YAHFA ](https://github.com/rk700/YAHFA ): previous ART hooking framework~
2021-03-22 18:28:53 +08:00
- ~[dexmaker ](https://github.com/linkedin/dexmaker ) and [dalvikdx ](https://github.com/JakeWharton/dalvik-dx ): to dynamically generate YAHFA hooker classes~
2022-03-15 21:18:02 +08:00
- ~[DexBuilder ](https://github.com/LSPosed/DexBuilder ): to dynamically generate YAHFA hooker classes~
2021-02-13 12:52:24 +08:00
## License
2021-03-08 23:20:53 +08:00
LSPosed is licensed under the **GNU General Public License v3 (GPL-3) ** (http://www.gnu.org/copyleft/gpl.html).
