Skip to main content
Set Up

Setting up the Android companion app

Last updated 6 months ago

The WorkCalmly Android companion app lets you block distracting apps on your Android phone during focus sessions.

What it does

The companion app connects to WorkCalmly and blocks the apps you choose whenever a focus session is active. It uses Android's accessibility and usage access features to automatically enforce blocking once set up.

How to set it up

  1. Download the WorkCalmly app from the Play Store.

  2. Open the app and follow the in-app instructions to generate and scan your QR code. This links the companion app to your WorkCalmly account.

  3. Grant Accessibility Service access — this allows the app to detect and block other apps.

  4. Grant Usage Access — this allows the app to monitor which apps are in use, so it knows when to block them.

  5. Allow Display over other apps — this lets WorkCalmly show a blocking screen on top of distracting apps.

  6. Enable Ignore Battery Optimization — this ensures the app keeps running in the background even when your phone is idle.

  7. Select the apps you want to block during focus sessions.

That's it. The next time you start a focus session, your selected apps will be blocked automatically.

Troubleshooting

  • QR code isn't scanning. Make sure your camera has enough light and hold it steady. You can regenerate the QR code in WorkCalmly under Settings > Distraction Blockers.

  • Apps aren't being blocked during a session. Check that all required permissions are still active — Accessibility Service, Usage Access, and Display over other apps can sometimes be reset by the system. Re-enable them in your phone's Settings > Apps > WorkCalmly.

  • Blocking stopped working after a while. Battery optimization may be interfering with the app running in the background. Make sure Ignore Battery Optimization is enabled for WorkCalmly in your phone's battery settings.