ShizuStore

壁纸设置器

BlizzardAn225

1.8.0 · GitHub

Download APK
Vendor-specific Android 10+ 1 week ago GPL-3.0
112 ShizuStore
1.3k GitHub
26 Stars
13 MB Size

More about this app

Restores scrolling wallpapers and disables forced darkening on HyperOS 3/4, applying secure settings and restarts through Shizuku.newProcess or a root module.

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.

Close

How Shizuku is used

Can restore scrolling wallpaper and toggle wallpaper zoom by applying system settings and restarting the wallpaper app via `newProcess`.

This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.

How this app uses Shizuku

Shizuku is used to apply protected wallpaper settings and restart the system wallpaper app so the changes take effect.

  • Restore scrolling wallpaper: tapping the enable button repeatedly writes the secure setting for wallpaper scroll span to 1 with the settings put command through Shizuku, then restarts the system wallpaper app so scrolling takes effect.
  • Toggle wallpaper zoom: choosing to turn wallpaper zoom on or off applies the system animation rate setting with the settings put command through Shizuku to enable or skip the zoom animation.

Android APIs or commands used

  • settings put secure pref_key_wallpaper_screen_scrolled_span
  • am force-stop com.miui.miwallpaper
  • settings put system miui_home_animation_rate

Notable details

Without Shizuku authorization the app instead copies the same commands to the clipboard for manual execution in a terminal, while image cropping and wallpaper setting continue to work through the normal system wallpaper API.

Close

Changelog

What's new for version 1.8.0

重大更新:

  • 升级:换用 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.
  • Fixed: 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.

Close

Permissions

6 permissions requested

  • android.permission.SET_WALLPAPER
  • android.permission.READ_EXTERNAL_STORAGE
  • android.permission.READ_MEDIA_IMAGES
  • android.permission.POST_NOTIFICATIONS
  • com.blizzard225.wallpapersetter.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
  • moe.shizuku.manager.permission.API_V23
Close

Sources

2 sources

1.8.0 GitHub · com.blizzard225.wallpapersetter
Selected Download
1.6.0 GitHub · com.blizzard225.wallpapersetter
Download