Trigger Macros from Mirabox Stream Dock without Hotkeys (New Plugin)

Tips & Tutorials
,
1

Hi everyone,

I've been using Keyboard Maestro for years and absolutely love it. Recently, I picked up a Mirabox Stream Dock (a cost-effective alternative to the Elgato Stream Deck, which I also own).

While the hardware is very nice, I was disappointed to find there was no native plugin to trigger KM macros directly (unlike the excellent support Elgato has). I didn't want to mess around with complex hotkey mapping for every single button.

So, I decided to build one.

Introducing KM Activator – a simple, lightweight plugin for Mirabox Stream Dock devices.

What it does:
It allows you to trigger any Keyboard Maestro macro instantly from your Stream Dock using the macro's UUID. It communicates directly with KM's built-in Web Server (localhost), so it's fast and secure. (Unfortunately, Stream Dock’s SDK doesn’t support Shell interaction, only uses html)

How to use it:

  1. Enable the Web Server in KM Settings (Port 4490).
  2. Install "KM Activator" from the Mirabox store (it's free).
  3. Copy a macro's UUID and paste it into the plugin action.

That's it. No scripts, no complex setups.

I built this primarily for my own workflow, but I realized others here might be using the same hardware and facing the same frustration. I just uploaded it to the store today.

If you have a Mirabox device, feel free to give it a try. I'd love to hear your feedback!

All the best,
Sagi

2 Likes
KM Link for MiraBox Stream Dock software?
2

Hi everyone,

About a month ago, I shared a basic plugin I built called "KM Activator" for the Mirabox Stream Dock. It got the job done using KM's Web Server, but let's be honest—manually copying and pasting Macro UUIDs for dozens of buttons gets tedious very quickly.

I previously mentioned that the Stream Dock SDK was limited to HTML/Web interactions. Well, I couldn't let that go. I went back to the drawing board, figured out how to completely bypass those limitations, and rewrote the entire backend from scratch in native Apple Swift.

Introducing KM Master!

It is a massive upgrade and provides the seamless Mac experience we are used to.

What’s new in KM Master?

  • No more copying UUIDs: The plugin automatically fetches all your enabled macros and displays them in a live, searchable dropdown list directly inside the StreamDock app.

  • No KM Web Server needed: It communicates locally and securely using native AppleScript/JXA. You don't need to enable the KM Web Server on port 4490 anymore.

  • Pass Parameters: You can now easily pass optional text values directly to your macros from the plugin UI.

  • Native & Lightning Fast: Built as a macOS Universal Binary in Swift. It weighs just ~350KB, runs natively on both Intel and Apple Silicon Macs, and has absolutely zero external dependencies.

Side-by-side migration: If you are currently using my older "KM Activator" plugin, don't worry! You can install KM Master alongside it. Your existing buttons won't break, and you can transition to the new dropdown method at your own pace.

:stop_sign: Important Install Note: Because this native version uses AppleEvents to communicate with KM at lightning speed, macOS will present a security prompt on its first run:

" 'StreamDock' wants access to control 'Keyboard Maestro'. " You must click 'Allow'. For it to work correctly, ensure that the toggle for Keyboard Maestro under StreamDock is turned ON in your Mac's System Settings > Privacy & Security > Automation.

The plugin is officially Live and free in the Mirabox store. I built this to perfect my own workflow, and I really hope it helps yours too. I'd love to hear your feedback!

All the best,
Sagi

2 Likes