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…
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
Variants
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
- r/selfhosted on Reddit: What are the companion mobile apps do you use ... (reddit)
- I'm launching a directory of self-hosted companion ... - Reddit (reddit)
- Introducing selfh.st/companions, a Directory of Companion Apps ... - Reddit (reddit)
- Looking for an easy self‑hosted AI girlfriend/assistant setup - Reddit (reddit)
- r/selfhosted on Reddit: What are some companion/third party apps you ... (reddit)
- Homebox Companion - AI-powered photo cataloging for your ... - Reddit (reddit)
Collected yesterday - public community threads
