Support

AwakeFlow keeps your Mac awake until a wait condition completes, then performs your chosen finish action. This page covers common questions and where to report issues.

Get help

• Bug reports & feature requests: GitHub Issues
• Privacy questions: Privacy Policy
• Source code & documentation: GitHub repository

When opening an issue, include your macOS version, AwakeFlow version, which edition you are using (Mac App Store or direct), and steps to reproduce the problem.

System requirements

• macOS 13 (Ventura) or later
• Apple silicon or Intel Mac

Permissions

AwakeFlow may ask for permissions depending on the features you use:

• Notifications — requested when a flow starts; used for finish alerts and failure messages.
• Bluetooth — used only if you add a “Bluetooth disconnects” wait step.
• Folder access — you choose folders for watching, downloads, or output files.

Direct distribution edition

The direct build may also request Automation for Lock and Shut Down finish actions, and can run shell commands you configure. If lock or shut down fails, open System Settings → Privacy & Security → Automation and allow AwakeFlow to control System Events.

Mac App Store edition

The App Store build does not include Run Command, quit-open-apps automation, Lock, Shut Down, or Apple Events. Finish actions are limited to Do Nothing, Notify, and Sleep (via IOKit).

Troubleshooting

Notifications do not appear

• Check System Settings → Notifications → AwakeFlow and ensure alerts are allowed.
• Start a flow once so AwakeFlow can request notification permission.

Sleep finish action did not work

• AwakeFlow uses Apple’s public IOKit sleep API. macOS may refuse sleep if other apps hold power assertions or if system policy blocks it.
• AwakeFlow shows a local notification when sleep is denied.

Folder or download access fails

• Re-select the folder or download destination in the flow editor so AwakeFlow can refresh its security-scoped bookmark.
• Ensure the Mac App Store build has permission to access Downloads if you save files there.

My saved flow changed after updating

• The Mac App Store edition migrates unsupported options (such as Run Command, Lock, or Shut Down) to safe alternatives when loading saved flows.

App information

• App name: AwakeFlow
• Bundle ID: com.imehdihosseini.awakeflow
• Developer: MehdI Hosseini
• Category: Utilities