HyperOS 3/4 Scroll Setter

中文 | English

澎湃OS 3/4 随屏滚动壁纸设置器

让澎湃OS 3/4 重新支持随屏滚动壁纸

澎湃OS 3 从官方壁纸设置界面中移除了随屏滚动功能,并在软件层面强制关闭普通壁纸的随屏滚动。

澎湃OS 3/4 随屏滚动壁纸设置器通过绕过这些限制,让小米澎湃OS设备重新使用随屏滚动壁纸。

功能

  • 重新启用澎湃OS 3/4 随屏滚动壁纸
  • 绕过「锁屏编辑」的壁纸裁切
  • 支持桌面与锁屏壁纸同步滚动
  • 禁止/对抗系统自动压暗壁纸
  • 分别为浅色模式、深色模式设置单独的壁纸(仅Root)
  • 支持 Root 和 Shizuku 两种模式
  • 针对澎湃OS 3、澎湃OS 4 分别进行适配

使用方法

Shizuku / 免 Root

  1. 启动 Shizuku,并授予本应用所需权限;
  2. 从相册选择图片;
  3. 设置壁纸;
  4. 在应用中开启「随屏滚动」。

澎湃OS 4 平板需要在「宿主设备」中选择正确的设备类型和屏幕分辨率。适用设备可以使用 3200×2136 预设值。

Root

  1. 激活模块;
  2. 重启设备;
  3. 使用本应用或系统原有方式设置桌面/锁屏壁纸;
  4. 开启「不压暗壁纸」后,需要重新启动一次「壁纸」APP。

    如果重启设备后进入桌面时壁纸短暂黑屏,可以在系统设置中手动结束一次「壁纸」APP进程。

兼容性

模式 设备 状态
Root 小米 17 Ultra、小米 17 Pro、小米 15 Pro、小米平板 8 Pro ✅ 已测试
Shizuku 小米 17 Ultra、小米平板 8 Pro、Redmi K Pad ✅ 已测试
Root 其他澎湃OS 3/4 小米设备 理论上可行
Shizuku 其他澎湃OS 3/4 小米设备 理论上可行,重启后可能需要重新开启随屏滚动

其他澎湃OS 3/4 设备也可能正常工作,但实际兼容性取决于具体系统版本及壁纸引擎实现。

从源码构建

git clone https://github.com/BlizzardAn225/HyperOS3ScrollSetter.git
cd HyperOS3ScrollSetter
# 在 Android Studio 中打开并构建

许可证

GPL-3.0

免责声明

随屏滚动壁纸已经不再受到澎湃OS官方支持,使用过程中可能出现:

  • 掉帧
  • 渲染错误
  • 从锁屏进入桌面时短暂黑屏

使用本项目产生的任何问题由用户自行承担。


Make HyperOS 3/4 Support Scrolling Wallpapers Again

HyperOS 3 removed scrolling wallpaper from the standard wallpaper-setting UI and added software-level restrictions that disable it for normal wallpapers.

HyperOS 3/4 Scroll Setter bypasses these restrictions and allows Xiaomi HyperOS devices to use scrolling wallpapers again.

Features

  • Enable scrolling wallpapers on HyperOS 3/4
  • Set wallpapers directly without the cropping performed by the Lock Screen Editor
  • Support synchronized home-screen and lock-screen scrolling
  • Disable/Convert automatic wallpaper darkening
  • Set separate wallpapers for light mode and dark mode (Root only)
  • Support Root and Shizuku modes
  • HyperOS 3 and HyperOS 4 specific adaptations

Usage

Shizuku / No Root

  1. Start Shizuku and grant the app the required permission;
  2. Select an image from the gallery;
  3. Set the wallpaper;
  4. Enable Scrolling Wallpaper in the app.

For HyperOS 4 tablets, configure the correct device type and screen resolution in the Host Device section. The 3200×2136 preset can be used where applicable.

Root

  1. Activate the module;
  2. Root the device;
  3. Set the home-screen and/or lock-screen wallpaper through the app, or use the original system method;
  4. Restart the Wallpaper app after enabling Don't Darken Wallpaper.

    If the home screen briefly becomes black after rebooting device, force-stop the Wallpaper app once from Settings.

Compatibility

Mode Device Status
Root Xiaomi 17 Ultra, Xiaomi 17 Pro, Xiaomi 15 Pro, Xiaomi Pad 8 Pro ✅ Tested
Shizuku Xiaomi 17 Ultra, Xiaomi Pad 8 Pro, Redmi K Pad ✅ Tested
Root Other Xiaomi devices running HyperOS 3/4 Theoretically supported
Shizuku Other Xiaomi devices running HyperOS 3/4 Theoretically supported; scrolling may need to be re-enabled after reboot

Other HyperOS 3/4 devices may also work, but compatibility depends on the system wallpaper implementation and version.

Building from Source

git clone https://github.com/BlizzardAn225/HyperOS3ScrollSetter.git
cd HyperOS3-Scroll-Setter
# Open the project in Android Studio and build

License

GPL-3.0

Disclaimer

Scrolling wallpapers are no longer officially supported by HyperOS. Unexpected behavior may occur, including:

  • Frame drops
  • Rendering errors
  • Temporary black screens when entering the desktop from the lock screen

Use the module at your own risk.

Releases

1.8.0

Stable

11/10/2026, 2:06:10 AM

重大更新:

  • 升级:换用 libxposed API 102,相关依赖、代码全部升级;
  • 新增:Root 模式下,可为设备在浅色模式、深色模式设置单独的桌面壁纸、锁屏壁纸;
  • 新增:浅色模式、深色模式壁纸预览切换时,裁剪框框选区域缓存,同分辨率下裁剪区域保持一致;
  • 修改:更好地支持 DCI-P3 色域的图片;
  • 修复:更新了防抖算法,适配更新的澎湃OS4。

若壁纸出现卡住的情况,请取消对系统框架的作用域、重启设备验证是否复现,如果不复现,请附带 /system_ext/framework/miui-services.jar 提交issue。


Major Update:

  • Upgrade: Switched to libxposed API 102; all related dependencies and code have been upgraded.
  • New: In Root mode, separate home screen wallpapers and lock screen wallpapers can be set for light mode and dark mode.
  • New: When previewing and switching between light mode and dark mode wallpapers, the crop box selection area is cached, keeping the crop area consistent at the same resolution.
  • Changed: Better support for DCI-P3 color gamut images.
  • Fixed: Updated the anti-shake algorithm to support the newer HyperOS 4.

If the wallpaper gets stuck, please disable the scope for System Framework, reboot the device, and check whether the issue reproduces. If it does not reproduce, please submit an issue with /system_ext/framework/miui-services.jar attached.

1.7.0

Stable

10/19/2026, 1:34:24 PM

更新日志:

  • 重构代码;
  • 新增:对系统框架的Hook,修改应用打断动画的壁纸缩放矩阵、写入动画平移量,避免壁纸在缩放时进行滚动导致的抖动,由于涉及对系统框架的Hook,更新模块后需要重启系统;
  • 新增:Shizuku免Root模式下关闭/开启壁纸缩放的开关;
  • 修改:Shizuku免Root模式下点击按钮的执行逻辑和提示,现在会先检查Shizuku状态再执行命令。

本次抖动修复基于澎湃OS4的平板,若澎湃OS3设备仍出现抖动问题,请附带/system_ext/framework/miui-services.jar提交issue。


Changelog:

  • Refactored the code.
  • Added: Hook into the system framework to modify the wallpaper scale matrix of the app's interrupt animation and write the animation translation offset, preventing jitter caused by wallpaper scrolling during scaling. Since this involves hooking the system framework, a system reboot is required after updating the module.
  • Added: A toggle in Shizuku no-root mode to enable/disable wallpaper scaling.
  • Changed: The execution logic and prompts when clicking buttons in Shizuku no-root mode. It now checks the Shizuku status before executing commands.

This jitter fix is based on a tablet running HyperOS 4. If jitter issues still occur on HyperOS 3 devices, please submit an issue with /system_ext/framework/miui-services.jar attached.

Assets

1

1.6.0

Stable

8/30/2026, 8:35:02 AM

适配Hyper OS4:

  • 新增宿主系统选择功能;
  • 新增适配HyperOS 4的Hook点位:阻止裁切;
  • Shizuku免Root模式新增逆运算扩展位图。

Adapted for HyperOS 4:

  • Added host system selection feature
  • Added Hook points adapted for HyperOS 4 to prevent cropping
  • Added inverse operation bitmap extension for Shizuku non-root mode

Assets

1

1.5.0

Stable

8/10/2026, 2:57:55 AM

不压暗壁纸

通过标准 Android API 设置壁纸时,系统会强制将 isNeedDark 设为 true,导致壁纸被压暗(亮度降低、饱和度下降、暗部更暗)。系统原生方式(锁屏编辑)设置时 isNeedDark 恒为 false,不会压暗。

本次更新对此作出处理:

  • Root 模式:拦截压暗逻辑,直接阻断
  • 免Root + Shizuku:写入位图前对像素做逆运算预提亮,近似抵消压暗效果

Don't Darken Wallpaper

When setting wallpaper via the standard Android API, the system forces isNeedDark to true, which darkens the wallpaper (reduced brightness, lower saturation, darker shadows). The native method (Lock Screen Editor) always sets isNeedDark to false, so no darkening occurs.

This update addresses it as follows:

  • Root mode: Intercepts and blocks the darkening logic
  • Non-root + Shizuku: Pre-brightens pixels via inverse operations before writing, approximately offsetting the darkening effect

Assets

1

7/30/2026, 11:56:22 AM

图标取色修复,现在图标取色和LSPosed管理器一样了。

Fixed icon color extraction, now it matches the LSPosed Manager.

Assets

1