{"id":658,"date":"2020-06-25T00:58:55","date_gmt":"2020-06-25T00:58:55","guid":{"rendered":"http:\/\/techministry.blog\/?p=658"},"modified":"2020-06-25T00:58:55","modified_gmt":"2020-06-25T00:58:55","slug":"walkthrough-using-a-streamdeck-and-midi-relay-to-control-faithlife-proclaim","status":"publish","type":"post","link":"https:\/\/techministry.blog\/?p=658","title":{"rendered":"Walkthrough: Using a streamdeck and midi-relay to control faithlife proclaim"},"content":{"rendered":"\n<p>If you&#8217;ve not heard of <a href=\"https:\/\/proclaim.faithlife.com\/\">Proclaim<\/a>, it is a presentation software similar in concept to ProPresenter. I&#8217;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 <a href=\"https:\/\/techministry.blog\/2019\/11\/20\/using-node-js-on-a-raspberry-pi-to-listen-to-midi-messages-from-an-avid-s6l-console-to-trigger-http-requests-or-run-scripts\/\">midi-relay<\/a> software.<\/p>\n\n\n\n<p>This walkthrough will be on the Mac platform.<\/p>\n\n\n\n<p>First, on the Proclaim computer, open the application, &#8220;Audio MIDI Setup&#8221;.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/audio-midi-setup.png?w=1024\" alt=\"\" class=\"wp-image-662\" \/><figcaption>The Audio MIDI Setup program.<\/figcaption><\/figure>\n\n\n\n<p>Now, in the Audio MIDI Setup application, go to Window &gt; Show MIDI Studio.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/audio-midi-setup-window.png?w=1024\" alt=\"\" class=\"wp-image-663\" \/><\/figure>\n\n\n\n<p>Double click on the IAC driver.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/midi-studio-1.png?w=1024\" alt=\"\" class=\"wp-image-665\" \/><\/figure>\n\n\n\n<p>Make sure the checkbox &#8220;Device is online&#8221;, and click Apply.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/iac-driver-enabled-1.png?w=955\" alt=\"\" class=\"wp-image-667\" \/><\/figure>\n\n\n\n<p>Now that the IAC driver is enabled, you need to download midi-relay on the Proclaim computer. You can get it here: <a href=\"https:\/\/github.com\/josephdadams\/midi-relay\">https:\/\/github.com\/josephdadams\/midi-relay<\/a> 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.<\/p>\n\n\n\n<p>Once midi-relay is running, you&#8217;ll see the terminal output window showing the available MIDI ports.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/screen-shot-2020-06-24-at-11.27.32-am.png?w=1024\" alt=\"\" class=\"wp-image-669\" \/><figcaption>You can see the IAC Driver Bus 1 listed here.<\/figcaption><\/figure>\n\n\n\n<p>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.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/companion_addmidi.png?w=1024\" alt=\"\" class=\"wp-image-671\" \/><figcaption>Search for &#8220;midi&#8221; in the search bar and the &#8220;Tech Ministry MIDI Relay&#8221; module should show up.<\/figcaption><\/figure>\n\n\n\n<p>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 <em>127.0.0.1.<\/em><\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/companion_midiconfig.png?w=1024\" alt=\"\" class=\"wp-image-672\" \/><\/figure>\n\n\n\n<p>Now create a new button with a midi-relay action. Choose &#8220;IAC Driver Bus 1&#8221; 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.)<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/companion_addaction.png?w=1024\" alt=\"\" class=\"wp-image-673\" \/><\/figure>\n\n\n\n<p>Now in Proclaim, go to Settings, and click the MIDI Input tab. Click &#8220;Add Command&#8221;.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/proclaim_settings.png?w=1024\" alt=\"\" class=\"wp-image-674\" \/><\/figure>\n\n\n\n<p>Select the command you want to be able to control from Companion. Here, I&#8217;ve chosen &#8220;Previous Slide&#8221;.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/proclaim_selectcommand.png?w=1024\" alt=\"\" class=\"wp-image-675\" \/><figcaption>There are a lot of options you can control within Proclaim!<\/figcaption><\/figure>\n\n\n\n<p>Once you select a command, Proclaim will start listening for the MIDI message.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/proclaim_listening.png?w=882\" alt=\"\" class=\"wp-image-676\" \/><\/figure>\n\n\n\n<p>Now go back to the Companion GUI and click &#8220;Test Actions&#8221; on your button.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/companion_testactions.png?w=680\" alt=\"\" class=\"wp-image-677\" \/><\/figure>\n\n\n\n<p>Proclaim will detect the MIDI message and apply it to the command.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/techministry.blog\/wp-content\/uploads\/2020\/06\/proclaim_midinote.png?w=876\" alt=\"\" class=\"wp-image-678\" \/><\/figure>\n\n\n\n<p>Repeat this for all the commands you want to control from your streamdeck with Companion and midi-relay.<\/p>\n\n\n\n<p>That&#8217;s it! I hope that is helpful! As always, if you need some help along the way, don&#8217;t hesitate to <a href=\"https:\/\/techministry.blog\/contact\/\">reach out<\/a> to me. If this post or others have helped you, take a minute and learn more <a href=\"https:\/\/techministry.blog\/about\/\">about me<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>If you&#8217;ve not heard of Proclaim, it is a presentation software similar in concept to ProPresenter. I&#8217;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 &hellip; <a href=\"https:\/\/techministry.blog\/?p=658\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;Walkthrough: Using a streamdeck and midi-relay to control faithlife proclaim&#8221;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[19,37,49,50,66],"class_list":["post-658","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-companion","tag-midi","tag-proclaim","tag-production","tag-stream-deck"],"_links":{"self":[{"href":"https:\/\/techministry.blog\/index.php?rest_route=\/wp\/v2\/posts\/658","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/techministry.blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/techministry.blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/techministry.blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/techministry.blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=658"}],"version-history":[{"count":0,"href":"https:\/\/techministry.blog\/index.php?rest_route=\/wp\/v2\/posts\/658\/revisions"}],"wp:attachment":[{"href":"https:\/\/techministry.blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=658"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/techministry.blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=658"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/techministry.blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=658"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}