← Directory

ajazz-companion-bridge

Use an Ajazz AKP05E (or compatible Mirabox) LCD button pad that is plugged into this Unraid server as a control surface for Bitfocus Companion.

  • Automation
  • Tools & Utilities
Use an Ajazz AKP05E (or compatible Mirabox) LCD button pad that is plugged into this Unraid server as a control surface for Bitfocus Companion. The bridge reads the pad over USB, talks to Companion through its Satellite API, shows Companion's button pictures on the pad and sends key presses, touch-strip taps, swipes and dial turns back. It reconnects by itself if the pad is unplugged or Companion restarts. SETUP: (1) In Companion enable Settings > Satellite API (port 16622) and switch off Settings > Surfaces > "Enable connected Mirabox Stream Dock devices". (2) Set "Companion host" below to the IP of the machine running Companion. (3) Set "USB HID device" below to the pad's /dev/hidrawN node. The pad appears as two hidraw entries; you need the one whose HID_PHYS ends in /input0. In the Unraid terminal run: for d in /sys/class/hidraw/hidraw*; do grep -q 00000300:00003004 $d/device/uevent

Platform availability

Available on 1 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

44/100 Fair

Maintained
72last commit 3 days ago
Popular
176 GitHub stars
Easy to install
201 install platform, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
6
Open issues
0
Last commit
2026-10-20
Latest release
v1.3.0
License
MIT
Activity
rising

Checked today - source: GitHub (dvortsis/ajazz-companion-bridge)

Resources & Compatibility

Requirements not published yet.

Checked today - source: Docker Hub image tags and published docs

First-install notes

No first-install notes yet.

Alternatives

No alternatives collected yet.

Common questions

Which Companion settings must be changed so the bridge can use the pad?

Enable Companion's Satellite API on port 16622. Also disable Settings > Surfaces > "Enable connected Mirabox Stream Dock devices" so Companion does not grab the pad itself.

Can Bitfocus Companion run on a different computer from the pad?

Yes. Companion can run on the same computer as the pad or on any other computer on your network.

Is the Ajazz AKP05E the only supported pad?

The AKP05E is the only pad stated as tested on real hardware. Other Ajazz and Mirabox pads are experimental and may or may not work.

Do I need to install Node.js to run the bridge?

If you run the project from source, Node.js 20 or newer is required. The ready-to-run release downloads include the runtime, so Node.js is not needed for those.

Does the bridge recover if the pad is unplugged or Companion restarts?

Yes. It reconnects on its own if the pad is unplugged or Companion restarts.

Answers sourced from github.com

Community

No community discussions collected yet.