// troubleshooting guide · alfred

Alfred Workflows Not Working

Status
Workaround available
platforms:
macOS
updated:
November 15, 2026
reports:
4
Method
how we research
Share

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

  1. FIX 1Update or replace the workflow

    1. 01Open Alfred Preferences > Workflows and double-click the workflow name to see the developer's details and link
    2. 02Download the latest version; for Python 2 workflows check Alfred's Updated Third-Party Python 2 Workflows repository
    Did this fix it?
  2. FIX 2Install Python if the workflow needs it

    1. 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
    2. 02Restart Alfred after reinstalling the workflow
    Did this fix it?
  3. FIX 3Re-enable the workflow

    1. 01If it's greyed out, right-click the workflow name in the sidebar and enable it
    Did this fix it?
  4. FIX 4Fix the workflow hotkey

    1. 01Make sure the Hotkey object is connected to the next object
    2. 02Double-click the Hotkey object, set the combo and save
    3. 03Check the Related Apps section for apps that limit the hotkey
    Did this fix it?
  5. FIX 5Ask with debug output

    1. 01Open the workflow and click the debug (bug) icon, run it and copy the log
    2. 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

Watch Alfred Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Alfred errors

All 10 Alfred errors and fixes →