If you’ve not heard of Proclaim, it is a presentation software similar in concept to ProPresenter. I’m not a user, but I have had several people write in and ask about how they could control it with a streamdeck, so I though I would share a quick post on how to do this with Companion and the midi-relay software.
This walkthrough will be on the Mac platform.
First, on the Proclaim computer, open the application, “Audio MIDI Setup”.
Now, in the Audio MIDI Setup application, go to Window > Show MIDI Studio.
Double click on the IAC driver.
Make sure the checkbox “Device is online”, and click Apply.
Now that the IAC driver is enabled, you need to download midi-relay on the Proclaim computer. You can get it here: https://github.com/josephdadams/midi-relay It is up to you if you want to run it directly from within Node or use a compiled binary. The results are the same.
Once midi-relay is running, you’ll see the terminal output window showing the available MIDI ports.
Now open Companion. It can be running on the same Proclaim computer, or another computer on the same network. In the Web GUI, create a new instance of the midi-relay module.
In the configuration tab, type in the IP address of the computer running midi-relay. If the same computer is running Companion as Proclaim (and midi-relay), you can type in 127.0.0.1.
Now create a new button with a midi-relay action. Choose “IAC Driver Bus 1” for the MIDI Port, and the other MIDI values as you like. Proclaim will detect them in the next step, so the channel, note, and velocity are not too important as long as the note is unique for each action you want to take (previous slide, next slide, etc.)
Now in Proclaim, go to Settings, and click the MIDI Input tab. Click “Add Command”.
Select the command you want to be able to control from Companion. Here, I’ve chosen “Previous Slide”.
Once you select a command, Proclaim will start listening for the MIDI message.
Now go back to the Companion GUI and click “Test Actions” on your button.
Proclaim will detect the MIDI message and apply it to the command.
Repeat this for all the commands you want to control from your streamdeck with Companion and midi-relay.
That’s it! I hope that is helpful! As always, if you need some help along the way, don’t hesitate to reach out to me. If this post or others have helped you, take a minute and learn more about me.
How different is this for Win10?
i can’t seem to make that work.
Hey Doug! You’ll likely need to install a virtual midi port and use that. Check out the free software “loopmidi” for Windows.
How do I get midi-relay to hear midi from Proclaim and activate a button in companion?
Darius, I missed replying to this somehow. Sorry! You should be able to use Proclaim’s outbound MIDI to send a MIDI message to one of the existing MIDI ports on your computer, and then configure a midi-relay trigger that when a message matches the trigger settings, it will send an outgoing HTTP message. You can easily trigger Companion buttons via HTTP.
LikeLiked by 1 person
I’m running into similar issues with Windows 10 – It’s getting as far as MIDI-Relay, but not beyond that.. Loop-midi doesn’t seem to help either.
Can you test with an external MIDI device to rule out an issue with midi-relay?
This wasn’t my issue but I’ll share my experience since I am having similar problems. I’m happy to start my own thread if you prefer but this one seemed relevant so here I am.
I’m also running midi-relay and loopMIDI.
midi-relay works for other devices, specifically my lights, but Companion uses a different MIDI port.
Companion (via midi-relay) “talks to” loopMIDI which does in fact see the correct number of bytes, but Proclaim doesn’t react
A different PC app, PocketMIDI, talks to loopMIDI and Proclaim sees those bytes just fine
LikeLiked by 1 person
Does midi-relay see the loopMIDI port? So odd that it wouldn’t react. Is there any kind of PC-based MIDI monitor you could run to see how it is being interpreted?
As of version 3.2, Proclaim now has native StreamDeck support. No more messing around with MIDI!