Skip to content

Latest commit

 

History

History
78 lines (51 loc) · 5.26 KB

README.md

File metadata and controls

78 lines (51 loc) · 5.26 KB

LSPosed Framework

Build Crowdin Download Total TotalLatest

Introduction

LSPosed is a great XPosed Framework, but it has a big problem, only manager can manage scope. LSPosed team don't accept PR for CLI or API Module, the TODO issues are old more one year and never completed, is more important the GUI changed many times but not CLI or API Module. In my fork API Module and CLI are implemented. CLI require root user because must access files readable only by root.

A Riru / Zygisk module trying to provide an ART hooking framework which delivers consistent APIs with the OG Xposed, leveraging LSPlant hooking framework.

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.

Supported Versions

Android 8.1 ~ 15 Beta 2.1

Install

  1. Install Magisk v24+ (For Zygisk flavor) or Magisk 23 (For Riru flavor)
  2. (For Riru flavor) Install Riru v26.1.7+
  3. Download and install LSPosed in Magisk app
  4. Reboot
  5. Open LSPosed manager from notification
  6. Have fun :)

Download

Note: debug builds are only available in Github Actions.

Migration

You can install LSPosed_mod on top of official LSPosed installation. If the app is installed and not parasitic, the app must be reinstalled from apk distribuited with LSPosed_mod.

Get Help

Only bug reports from THE LATEST DEBUG BUILD will be accepted.

  • GitHub issues: Issues
  • Wiki
  • (For Chinese speakers) 本项目只接受英语标题的issue。如果您不懂英语,请使用翻译工具

For Developers

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.

We use our own module repository. We welcome developers to submit modules to our repository, and then modules can be downloaded in LSPosed.

Translation Contributing

You can contribute translation here.

Credits

  • LSPosed: fork source (makes all these possible)
  • Magisk: makes all these possible
  • Riru: provides a way to inject code into zygote process
  • XposedBridge: the OG Xposed framework APIs
  • Dobby: used for inline hooking
  • LSPlant: the core ART hooking framework
  • EdXposed: fork source
  • XZ Embedded: for decompress debug_info section into stripped libraries
  • SandHook: ART hooking framework for SandHook variant
  • YAHFA: previous ART hooking framework
  • dexmaker and dalvikdx: to dynamically generate YAHFA hooker classes
  • DexBuilder: to dynamically generate YAHFA hooker classes

License

LSPosed is licensed under the GNU General Public License v3 (GPL-3) (http://www.gnu.org/copyleft/gpl.html).