Companion

Bitfocus Companion is a self-hosted control-surface app that turns an Elgato Stream Deck or any touchscreen into a professional shotbox for presentation…

  • Home Automation
  • Productivity
  • Tools & Utilities
Bitfocus Companion is a self-hosted control-surface app that turns an Elgato Stream Deck or any touchscreen into a professional shotbox for presentation switchers, video playback software, and broadcast equipment. It includes a built-in Stream Deck emulator and a web page for touch screens, and can trigger buttons via OSC, TCP, UDP, HTTP, WebSocket, and Art-Net, so no physical buttons are required. This entry provides an unofficial Docker image, updated to the latest stable release once a month.

Platform availability

Available on 1 of 10 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)
  • Any server (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.

73/100 Good

Maintained
100last commit 13 days ago
Popular
8010,089 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
108 GB minimum RAM
Security check
94no serious findings, 1 minor, CI, tests

Availability: platform listings confirmed today, links checked 32 days ago

GitHub stars
10,089
Open issues
0
Last commit
2026-11-08
Latest release
v0.5.66
License
MIT
Activity
declining

Checked 13 days ago - source: GitHub (companion-inc/feynman)

Resources & Compatibility

Minimum requirements: 8 GB RAM, 6 GB disk. ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set a real database password Replace the placeholder database password 'kemal' with a stronger password when creating the database, and use that same password in config/config.yml. If the two do not match, the app cannot log in, and a weak password leaves your data exposed. source
  • Add your po_token and visitor_data After copying config/config.example.yml to config/config.yml, add the po_token and visitor_data values you generated earlier. These tokens tell the app how to handle visitor privacy; missing or wrong values can make Companion fail to start or run with the wrong defaults. source
  • Create a database volume first Run podman volume create invidious-db before starting the database container so the database has a named, persistent storage location. Without it, your channels, video data, and settings may disappear when containers are removed. source

Fetched 54 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Can I configure Companion over the network?

Yes, the web admin lets you configure the system from any browser on the network.

Can I use Companion as a touchscreen control surface?

Yes, it includes a webpage for touch screens and virtual web buttons for mobile, tablet, and browser use.

Can I trigger Companion actions without physical buttons?

Yes, buttons can be triggered via OSC, TCP, UDP, HTTP, WebSocket, and ArtNet.

Can one Companion instance control multiple Stream Decks?

Yes, it supports multi-device use and can have multiple Stream Decks connected at once.

Can I use Companion buttons in the native Stream Deck app?

Yes, the Stream Deck plugin lets you use Companion buttons in the native Stream Deck application.

Answers sourced from bitfocus.io

Community

Collected yesterday - public community threads