// troubleshooting guide · alfred
Alfred Workflows Not Working
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 15, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · alfred/workflows-not-working5 FIXES
// quick answer
Broken workflows are usually outdated third-party workflows (especially Python 2 ones broken since macOS 12.3), disabled workflows, or hotkeys not connected. Update the workflow, check Alfred's updated Python workflows repository, and open the workflow's debugger.
Most likely fix: Update or replace the workflow
How to fix it
// try these in order, the most common fix is first
FIX 1Update or replace the workflow
- 01Open Alfred Preferences > Workflows and double-click the workflow name to see the developer's details and link
- 02Download the latest version; for Python 2 workflows check Alfred's Updated Third-Party Python 2 Workflows repository
Did this fix it?FIX 2Install Python if the workflow needs it
- 01For workflows still calling /usr/bin/python, install Python 2.7 manually or point the script to a Python 3 interpreter as the developer instructs
- 02Restart Alfred after reinstalling the workflow
Did this fix it?FIX 3Re-enable the workflow
- 01If it's greyed out, right-click the workflow name in the sidebar and enable it
Did this fix it?FIX 4Fix the workflow hotkey
- 01Make sure the Hotkey object is connected to the next object
- 02Double-click the Hotkey object, set the combo and save
- 03Check the Related Apps section for apps that limit the hotkey
Did this fix it?FIX 5Ask with debug output
- 01Open the workflow and click the debug (bug) icon, run it and copy the log
- 02Post it in the Workflows Help & Questions section of alfredforum.com
Did this fix it?
Symptoms
A workflow does nothing, shows 'bad interpreter: No such file or directory' or Code 126, its hotkey doesn't fire, or it stopped working after a macOS update.
Why it happens
- C-01Workflow written for Python 2, removed in macOS 12.3
- C-02Workflow out of date with the app it controls
- C-03Workflow disabled (greyed out)
- C-04Hotkey object not connected or not set
- C-05Related Apps setting limits where the hotkey works
// this guide also covers
- alfred workflow not working
- alfred workflows stopped working
- alfred python workflow monterey
- alfred bad interpreter
Still not working?
If Alfred keeps failing, you're not alone. See every Alfred problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to us