Installation & Updates

Screen Recording stopped working after I updated Leafy

This can happen the first time you open Leafy after a recent update. It's a one-time hiccup, not a bug: just say "yes" to the permission one more time and it's fixed for good.

Why this happens

Some updates change Leafy enough that macOS treats it like a new app and forgets you'd already granted Screen Recording.

Leafy may still show as "on" in System Settings, but scanning will fail or show a black screen. The permission is just stale, not actually broken.

How to fix it

  1. Quit Leafy completely: click the Leafy icon in your menu bar (top-right of your screen), then choose Quit Leafy. Just closing the window isn't enough. The Leafy menu bar dropdown with "Quit Leafy" highlighted at the bottom
  2. Open System Settings → Privacy & Security → Screen Recording. macOS System Settings open to Privacy & Security → Screen & System Audio Recording
  3. If Leafy is listed there, remove it from the list: select Leafy and click the (minus) button below the list. Turning the switch off isn't enough. The stale entry has to be removed so macOS asks fresh. The Screen Recording settings list showing Leafy with its switch on, next to the remove button
  4. Open Leafy again, then press ⌥A (the scan shortcut). With the old entry removed, macOS asks for permission again, and Leafy will show you a window like this. Leafy's "Enable two permissions" window, with Grant buttons for Screen Recording and Accessibility
  5. Go back to Screen Recording settings and turn the switch on for Leafy, or drag Leafy straight from that window into the System Settings list.
  6. macOS will ask to quit and reopen Leafy: click Quit & Reopen. The permission won't take effect until Leafy restarts. macOS system prompt reading "Leafy may not be able to record the contents of your screen until it is quit" with a Quit & Reopen button

This is a one-time thing

Future updates won't ask you to do this again.

Still stuck? Email us at binjto@gmail.com and we'll help you sort it out, or chat with us on Discord.

Leafy only ever reaches out from binjto@gmail.com, Discord as jtobin0935, or u/Thin-Lawfulness-7861 on Reddit, and nowhere else.