MIDI-HA Bridge app icon MIDI-HA Bridge
Setup Guide

From slide to room, in a few steps.

MIDI-HA Bridge connects three things you already run: Logos Proclaim sends a MIDI note, macOS carries it on a virtual port, and the app calls Home Assistant. Set each one up once and a slide can run the whole room.

The signal path: Proclaim → MIDI-HA Bridge’s built-in MIDI port → Home Assistant scene / script / device.

Before you start

A short checklist — gather these first and the rest takes about a minute.

  • A Mac (Apple Silicon or Intel) running MIDI-HA Bridge.
  • Home Assistant reachable on the same network (e.g. http://homeassistant.local:8123).
  • A MIDI source — Logos Proclaim, or any app that can send MIDI (ProPresenter, Ableton, Logic, QLC+).

1 · Home Assistant — create an access token

MIDI-HA Bridge talks to Home Assistant with a Long-Lived Access Token. You create it once.

  1. Open your profile

    In Home Assistant, click your user name (bottom-left) to open your profile, then open the Security tab.

  2. Create a Long-Lived Access Token

    Scroll to Long-Lived Access Tokens → Create Token. Name it MIDI-HA Bridge.

  3. Copy it now

    Copy the token immediately — Home Assistant shows it only once. You will paste it into the app in the next step.

Also note your HA address — for example http://homeassistant.local:8123 or your http://<ip>:8123. You will need it next.

2 · MIDI-HA Bridge — install & connect

Everything below is set inside the app — no files to edit by hand, no YAML.

  1. Install

    Open the .dmg, drag MIDI-HA Bridge to Applications, and launch it. It runs from the menu bar with no Dock icon.

  2. Open Settings

    Click the menu-bar icon and choose Settings…

  3. Connect Home Assistant

    Paste your HA address and the Long-Lived Access Token from step 1. The app confirms the connection.

  4. Pick your MIDI port

    Leave it on MIDI-HA Bridge (built-in virtual port) — the app creates this port itself, so there is nothing to set up in macOS. (Advanced: you can instead pick an IAC bus or a hardware port for custom routing.)

MIDI-HA Bridge settings window showing Home Assistant connection, MIDI port, and note-to-action mapping
The Settings window — Home Assistant connection, MIDI port, and note mapping in one place.

3 · Proclaim — send MIDI on a slide

Proclaim sends MIDI through its Lighting/MIDI feature. Point it at the MIDI-HA Bridge port and pick a note for each cue.

  1. Enable outbound MIDI

    In Proclaim, select MIDI in Lighting Scene > Add control and select MIDI-HA Bridge as the destination.

  2. Add a Signal to a slide or cue

    Attach a MIDI Note On signal to the slide or service item that should change the room — for example the first worship slide, the sermon slide, or a “lights down” cue.

  3. Choose a note number

    Give each cue a distinct note. You will map those same notes to Home Assistant actions in the next step.

Exact menu locations live in Proclaim’s own docs: Lighting Scenes & Outbound MIDI. Any other MIDI source works the same way — just send notes to the MIDI-HA Bridge port.

4 · Map notes to actions

The final link: tie each incoming note to something Home Assistant can do.

  1. Add a mapping

    In MIDI-HA Bridge Settings, add a row for each note: the note number from Proclaim on the left, the Home Assistant action on the right.

  2. Pick the action

    Choose a scene, a script, or any service — scene.turn_on, script.start_service, a light, a switch, anything Home Assistant exposes.

  3. Save & test

    Save the settings, then advance the matching slide in Proclaim. The room should follow the cue.

Something not working? → Troubleshooting Pricing