KernelSU Legacy+

Modern Action and WebUI support for older KernelSU setups.

A companion app based on KernelSU v1.0.1 / 11928, with selected newer module-management features backported for legacy installations.

Newer devices can use it too. For example, with Root My Galaxy you can first grant Legacy+ root, remove the original KernelSU Manager APK afterwards if your setup no longer needs it, and simply keep using Legacy+ as your Manager. This can also be useful on setups where apps react to the original KernelSU package being installed.

What it adds

- Run a module's action.sh directly from the module list - Open module WebUIs from webroot/index.html - Show Action output and logs inside the app - Use a patched legacy ksud with module action <id> support - Install alongside the normal KernelSU Manager - Leave the existing kernel and KernelSU integration untouched

Why a companion app?

Some older KernelSU kernels expect the official Manager identity and signature. Replacing the normal Manager with a modified APK is a bad idea on setups where the kernel still relies on that identity for authorization.

Legacy+ avoids that by using its own package ID:

me.weishu.kernelsu.legacyplus

The normal KernelSU Manager can stay installed and continue doing its job where the kernel expects it. Legacy+ sits beside it and gets root access like any other root app.

On setups where the underlying root implementation does not require the original Manager to remain installed after authorization, Legacy+ can also be used on its own as the module-management frontend.

Why not just update KernelSU?

Because a working kernel is sometimes more valuable than a newer Manager. Older devices, ROM-specific kernels, and custom builds can depend on a particular KernelSU integration. Updating the whole stack just to get newer Manager features can create unrelated problems.

Legacy+ takes the safer approach: keep the working kernel, improve the part you actually interact with.

Important limitation: Legacy+ can backport Manager-side functionality, but it cannot magically add kernel-side features that only exist in newer KernelSU versions. If a module genuinely requires a newer KernelSU kernel or UAPI, the companion app alone cannot provide that.

Module Actions

Modules can provide an Action script at:

/data/adb/modules/<module-id>/action.sh

When Legacy+ finds one, it exposes an Action control for that module. The bundled legacy ksud has been patched to understand:

ksud module action <module-id>

Actions can be launched from the app instead of manually opening a shell and running the script yourself. Output from the Action is captured and displayed in the app — useful for modules that use their Action for diagnostics, setup steps, logs, bug reports, or other one-shot tasks.

Module WebUI

Modules can also provide a local WebUI at:

/data/adb/modules/<module-id>/webroot/index.html

If that file exists, Legacy+ exposes an Open/WebUI control for the module. The page is loaded locally inside the app and includes the bridge needed for KernelSU-style interaction. If a module does not ship a WebUI, the button simply does not appear.

Installation

Keep your normal KernelSU Manager installed if your setup still depends on it for Manager authorization.

Then:

1. Install the KernelSU Legacy+ APK. 2. Open Legacy+. 3. Grant it root access. 4. Open the Modules page.

From there:

- action.sh → Action control - webroot/index.html → Open/WebUI control

On compatible setups, both apps can stay installed at the same time.

Requirements

- JDK 21 - Android SDK - Android NDK - Rust toolchain

Base

The current Legacy+ build is based on KernelSU v1.0.1 Manager version code 11928. That generation was chosen because it fits the older KernelSU stack this project was originally made for while still being a practical Manager base to extend.

Current status

- Builds and installs as an Android APK - Installs alongside the official KernelSU Manager - Supports legacy ksud module Actions - Handles Action detection, execution and output - Supports module WebUIs - Includes terminal and VS Code APK builds

Some modules may still behave differently depending on how they use newer KernelSU features.

License

GNU General Public License v3.0