MIDI-HA Bridge app icon MIDI-HA Bridge
Troubleshooting

Let’s get it working.

Most issues come down to one of three links in the chain — the MIDI port, the Home Assistant connection, or the Proclaim signal. Start with the matching section below. New here? The Setup Guide walks through everything from scratch.

Nothing happens when I advance a slide

Work down the signal path — one of these is almost always it.

  • App running? MIDI-HA Bridge must be running — it creates the MIDI-HA Bridge MIDI port that Proclaim sends to. Look for its menu-bar icon.
  • Proclaim sending? Outbound MIDI must be on, with MIDI-HA Bridge as the destination, and a Note On signal on that slide.
  • Same note? The note number Proclaim sends must match a mapping row in the app.
  • Home Assistant reachable? The app must be connected (see below) and the mapped scene/script must exist.

The app isn’t receiving MIDI

  • Set the app’s MIDI port to MIDI-HA Bridge (the built-in virtual port), and point Proclaim at the same port.
  • If a sending app doesn’t list MIDI-HA Bridge, make sure the app is running first, then reopen that app’s MIDI settings so it re-scans ports. (Some hosts, e.g. Logic Pro, only see the port when an external/MIDI track is open.)
  • Test with any MIDI source — if a keyboard or another app triggers it, the issue is on the Proclaim side.

Home Assistant won’t connect

  • Double-check the address (e.g. http://homeassistant.local:8123) and that the Mac can reach it in a browser.
  • Re-create the Long-Lived Access Token (HA → profile → Security) and paste it again — tokens can be revoked or expire.
  • Keep the Mac and Home Assistant on the same network.
Using a per-app firewall (e.g. Little Snitch, LuLu)? Allow MIDI-HA Bridge outbound network access — a blocked rule makes the app look connected while calls silently fail.

I got an email that Home Assistant stopped responding

That is the built-in health check doing its job: MIDI-HA Bridge watches Home Assistant from the outside and emails you when it stops responding. Check that Home Assistant is powered on and reachable. When it recovers, the cue flow resumes on its own.

Still stuck?

Read the Setup Guide