CustomOSHelper

An LSPosed enhancement module for ported devices

📖 About

CustomOSHelper is an LSPosed-based Xposed module that bridges two families of HALs into stock vendor systems on ported devices:

LineageOS standard HALs — LiveDisplay, Touch, PowerHal — independently defined and maintained by LineageOS
ChenSysHelper — a custom AIDL service providing additional HALs not covered by LineageOS (Sensor, Motor, Perf, FOD, etc.)

This module provides the Java/Kotlin glue layer for both, fixing features that break when HALs are missing.

Currently targeting HyperOS 3.0 (Android 16); support for more systems planned.

LineageOS standard HALs (independent of ChenSysHelper)

HAL	Interfaces	Description
LiveDisplay	`IDisplayModes`, `IColorBalance`, `IPictureAdjustment`, etc. (10)	Color profiles, reading mode, anti-flicker, sunlight enhancement
Touch	`ITouchscreenGesture`, `IGloveMode`, `IHighTouchPollingRate`, etc. (6)	Screen-off gestures, glove mode, key disabler/swapper
PowerHal	`IPower`, `IPowerHintSession`	Power hint sessions

ChenSysHelper (custom, no HAL equivalent in LineageOS)

HAL	Interfaces	Description
Sensor	`ISensorHelper`	Pocket/pickup/motion detect remapping
Motor	`IMotorHelper`	Pop-up camera motor control
Perf	`IPerfHelper`	Performance tier configuration
FOD	`IFodHelper`	Under-display fingerprint touch events
Common	`ICommon`	General-purpose helper extensions

Screen-off gestures — HAL-level touch gestures (single/double tap, swipe, letter shapes) with customizable actions
IFAA fingerprint payment — IFAA service hook for Alipay fingerprint auth on Oplus devices
Voice trigger — Force voice wake-up support via LegacyVoiceTriggerUtil hook
Refresh rate — Force custom refresh rate mode in PowerKeeper
LiveDisplay — Full LiveDisplay feature adaptation (10+ display enhancements)
Device info card — Hardware specs injection into Settings (SoC, battery, camera, display)
Alert Slider — Three-position slider support (OnePlus devices)
Sensor remapping — Pocket/pickup/motion detect sensor compatibility
Camera motor key — Pop-up camera protection with confirmation dialog
FOD / UDFPS — Enhanced under-display fingerprint touch handling
And more...

Enable the module in LSPosed Manager
Check recommended scopes: system, com.android.systemui, com.android.settings, etc.
Restart target apps (or use Hot Reload)
Configure features in the module settings