Restore the old HyperOS two-finger small-window gesture on HyperOS 4 (Xiaomi 17 Pro Max, Android 17).
On older HyperOS/MIUI versions, while an app is foreground you could:
- Swipe up from the bottom edge with your thumb and keep holding (enters recents drag).
- Press anywhere with your index finger (nothing visible happens yet).
- Release your thumb — the window glides to the index-finger position over 180 ms.
- Move the index finger if needed, then release it to drop the window into small-window mode there.
On HyperOS 4 the second finger cancels the drag instead. This module uses the unified MiuiHome HYOS native runtime provided by Zygisk Next and LSPosed IT, then projects the physical two-finger input into one continuous launcher drag stream with a frame-driven handoff.
- Official HyperOS 4 / Android 17 firmware, arm64-v8a
- Zygisk Next 1.5.0+
- LSPosed IT 2.1.1+ with HYOS-spawner support (libxposed API 102)
- Root (Magisk / APatch / KernelSU)
Validated official MiuiHome builds on Xiaomi 17 Pro Max (2509FPN0BC): 801025361 / RELEASE-8.01.02.5361-260807-08161657-R, 801025459 / RELEASE-8.01.02.5459-260807-08242024-R, 801026241 / RELEASE-8.01.02.6241-260818-09051525-R, and 801027719 / RELEASE-8.01.02.7719-260904-09181618-R. Official launcher updates are matched by validated native behavior structure rather than a version whitelist; missing or ambiguous structures fail closed.
Modified official ROMs and ported/custom ROMs are outside this project's support and issue-triage boundary. Report their runtime or gesture differences to the ROM maintainer.
- Install the APK from the latest Release.
- Enable the module in LSPosed, scope:
com.miui.home. - Reboot.
- Native log:
adb logcat -s SmallWindowNative:I - Diagnostics build: every release also carries
io.github.zilewang7.smallwindow-*_debug_diag.apk; it writes to/data/user_de/0/com.miui.home/cache/smallwindow_native.log(root-readable) - Source: https://github.com/zilewang7/HyperOS4SmallWindowInputFilter
恢复 HyperOS 4（小米 17 Pro Max，Android 17）上的旧版双指挂小窗手势。
旧版系统上：拇指从底部上滑进入多任务并按住 → 食指按住任意位置 → 松开拇指，窗口在 180 ms 内平滑移动到食指位置 → 可继续移动食指调整位置，松开食指后挂成小窗。HyperOS 4 上第二指会取消拖拽，本模块通过 Zygisk Next 与 LSPosed IT 提供的统一 MiuiHome HYOS native runtime，将物理双指输入投影成连续的桌面单指拖拽流并逐帧完成换指。
- 需要：官方 HyperOS 4 / Android 17、arm64-v8a、Zygisk Next 1.5.0+、LSPosed IT 2.1.1+（支持 HYOS spawner / libxposed API 102）、Root
- 已在小米 17 Pro Max（
2509FPN0BC）验证官方桌面：801025361/RELEASE-8.01.02.5361-260807-08161657-R、801025459/RELEASE-8.01.02.5459-260807-08242024-R、801026241/RELEASE-8.01.02.6241-260818-09051525-R与801027719/RELEASE-8.01.02.7719-260904-09181618-R - 官方桌面更新按已验证的 native 行为结构匹配，不使用版本白名单；结构缺失或歧义时失败关闭
- 官改包、移植包及其他第三方修改系统不在本项目的支持和问题受理范围内；请向对应系统维护者反馈
- 安装：安装最新 Release 的 APK → LSPosed 中启用并勾选
com.miui.home作用域 → 重启 - 日志：
adb logcat -s SmallWindowNative:I - 诊断版：每个 Release 附带
io.github.zilewang7.smallwindow-*_debug_diag.apk，日志写入/data/user_de/0/com.miui.home/cache/smallwindow_native.log（root 可读） - 源码：https://github.com/zilewang7/HyperOS4SmallWindowInputFilter