//
Sign In

Permissions & first-run setup

On first launch MacroForge walks you through the three permissions it needs. The last one decides whether a long macro keeps running when you put the phone down.

If you skipped the wizard or want to see it again, Reset Setup Wizard in shows it on next launch. The current state of each permission is also listed there under Permissions, with a way back to the system screen if one gets revoked.

The accessibility permission disclosure

Accessibility Service

The one that actually runs your macros. MacroForge uses Android's AccessibilityService API for two things:

  • Perform gestures, to click, swipe and scroll on your behalf.
  • Read screen content, so , and can react to what is on screen.

It only ever acts on the macros you create and start yourself, and what it reads is processed on your device. We do not collect or share it.

Android sometimes turns accessibility services off on its own, usually after an update or a force-stop. If macros suddenly do nothing at all, this is the first thing to check.

Display Over Other Apps

Lets MacroForge draw on top of whatever you are automating. Without it there is no control panel, no editor overlay, no and no stop button, so the app is not usable without it.

Ignore Battery Optimization

Marked optional, but grant it for anything long-running.

Android suspends apps it thinks are idle, and a macro waiting on a detection looks idle. With battery optimisation on, Android can stop a long macro partway through. Disable Optimization prevents that.

Grant it if you run macros overnight or with long waits. It is the most common cause of a macro that stops with nothing in the explaining why.

Some manufacturers (Xiaomi, Samsung, Oppo, Transsion and others) add their own power manager. If macros still stop on long runs, add MacroForge to the "protected apps" or "auto-start" list in your system settings too.

Screen capture

If Screen Capture Engine in is set to Media Projection, Android asks you to allow screen sharing each time capture starts. Set it to Accessibility to skip those prompts, at the cost of speed.