YukiSU

English | 简体中文 | 日本語 | Türkçe | Русский

A kernel-based root solution for Android devices, forked from SukiSU-Ultra, with some useless parts removed and some interesting changes added.

⚠️ Important Notice

YukiSU userspace has been completely rewritten in C++ (previously based on Rust). This means that YukiSU may behave differently from other KernelSU forks. If you encounter any issues, please report them to us rather than to upstream projects.

Features

1. Kernel-based su and root permission management
2. Built-in Kagami module mounting, with support for external MetaModule mounting backends and lifecycle scripts
3. App Profile and per-app non-root configuration
4. Dynamic manager support, allowing trusted managers outside the built-in package name/signature path to be configured
5. APatch-style SuperKey authentication, supporting both compile-time keys and keys injected into the LKM by ksud
6. ADB root, sulog, SELinux hide, module init.rc injection, and other upstream features
7. Built-in YukiZygisk, a kernel-based Zygisk implementation, fully compatible with Zygisk Next modules
8. TSR-based sucompat/syscall hook infrastructure
9. UTS view functionality, supporting uname spoofing by modifying uts_ns without rebuilding the kernel
10. Integrated Kasumi hide-rule management and configurable su paths
11. Lua plugins with configuration, logs, and support for multiple plugin repositories
12. Material 3 Expressive manager with ImgPatch image patching and a ramdisk editor

Compatibility Status

• YukiSU currently supports only loadable kernel modules (CONFIG_KSU=m) and no longer supports built-in CONFIG_KSU=y.
• YukiSU supports LKM mode on Android GKI 2.0 devices (kernel 5.10+). GKI 1.0 kernels and non-GKI kernels are not supported.
• YukiSU supports only arm64-v8a devices; the manager requires Android 12 (API 31) or later.
• YukiZygisk supports building and injection for both the arm64-v8a and armeabi-v7a ABIs.

Installation

See guide/installation.md

One-shot scripts

Module hot installation: guide

Module preinit

Integration

See guide/how-to-integrate.md

Troubleshooting

1. Device stuck after uninstalling the manager? Please uninstall com.sony.playmemories.mobile

Sponsor

• Anatdx (maintainer of YukiSU)
• ShirkNeko (maintainer of SukiSU)
• weishu (author of KernelSU)

License

• Files under the “kernel” directory are licensed under GPL-2.0-only.
• All other parts not mentioned above are licensed under GPL-3.0 or later.

Credits

• KernelSU: upstream
• MKSU: Magic Mount
• RKSU: non-GKI support
• KernelPatch: KernelPatch is a key part of APatch's kernel module implementation

KernelSU credits

• Kernel-Assisted Superuser: source of the KernelSU idea
• Magisk: a powerful root tool
• genuine: APK v2 signature verification
• Diamorphine: some rootkit techniques