← Back to Troubleshooting

📱 Xiaomi & HyperOS Setup Guide

To ensure Scrollless works correctly on your Xiaomi device, you need to grant a few specific "hidden" permissions. Xiaomi’s battery-saving features often stop background apps from working unless these steps are followed.

1

Enable the "Pop-up" Permission

Without this, the blocker cannot show the "Time Limit Reached" screen.

  1. Long-press the Scrollless icon on your home screen and tap App Info (the "i" icon).
  2. Tap on Other Permissions.
  3. Find Display pop-up windows while running in the background and set it to Always allow.
2

Disable Battery Restrictions

This prevents Xiaomi from "killing" the app to save battery.

  1. On the same App Info screen, tap on Battery Saver.
  2. Select No Restrictions.
3

Enable Autostart

This ensures the blocker starts automatically when you turn your phone on.

  1. On the same App Info screen, toggle Autostart to ON.
  2. (Optional) If prompted about battery usage, tap OK.
4

"Lock" the App (Recommended)

This is the best way to keep the app running in the background.

  1. Open Scrollless.
  2. Open your Recent Apps screen (swipe up and hold square button).
  3. Long-press on the Scrollless window.
  4. Tap the Padlock icon.

Once locked, a small padlock appears next to the app name. The app will stay active even if you clear all apps.

💡 Why is this necessary?

Unlike Samsung or Google phones, Xiaomi devices use a system called MIUI/HyperOS. This system is designed to save battery by aggressively closing apps. These steps "whitelist" our app so it can stay active and effectively help you manage your screen time.

Still having issues? Reach out to us at scrollless.app@gmail.com.