# Bitfocus Companion

Bitfocus Companion is an official, open-source control-surface program for streamers, presenters, and broadcast users that turns an Elgato Stream Deck, touchscreen, or built-in emulator into programmable buttons for. It is open source and self-hosted, installable on Proxmox and Unraid.

Canonical page: https://ourlocalhost.com/app/2661/bitfocus-companion

## Description

Bitfocus Companion is an official, open-source control-surface program for streamers, presenters, and broadcast users that turns an Elgato Stream Deck, touchscreen, or built-in emulator into programmable buttons for switchers, video playback, and broadcast equipment. It supports triggers over Open Sound Control (OSC), Transmission Control Protocol (TCP), User Datagram Protocol (UDP), HyperText Transfer Protocol (HTTP), WebSocket, and Art-Net, and does not require a physical Stream Deck.

## Platform availability

Available on 2 of 10 platforms: Unraid, Proxmox.

## Health score

81/100 (Excellent), based on 4 of 4 factors.
- Maintained: 100 (last commit 8 days ago)
- Popular: 67 (2,367 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Light to run: 100 (64 MB minimum RAM)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=bitfocus-companion
- Official website: https://bitfocus.io/companion/
- Unraid: https://ca.unraid.net/apps/bitfocus-companion-0jw2g991wh1521?q=Bitfocus-Companion
- Documentation: https://bitfocus.io/docs
- GitHub: https://github.com/bitfocus/companion

## Common questions

### Which Docker ports must I expose for Bitfocus Companion?

Expose 8000 for the web setup page and 16622 and 16623 for Companion's connection ports. Missing these mappings can stop setup or external use.

### Where should I store Companion's configuration in Docker?

Attach a volume to /companion. This keeps buttons, settings, and device data outside the container so they survive deletion or recreation.

### How should I install Bitfocus Companion on Linux without Docker?

Run the official Linux install script as root. It handles user creation, dependencies, and system configuration to reduce manual setup errors.

### How can I manage Bitfocus Companion from another computer?

Use the web admin to configure the system from any browser in the network. It also provides virtual web buttons for mobile, tablet, or browser use.

## Alternatives

- Elgato Stream Deck: Customizable virtual control panels for Mac, Windows, iOS, and Android with plugin integration, multi-actions, profiles, personalized icons…
- Loupedeck: Loupedeck is a downloadable software that provides native integrations with leading creative applications, offering customizable consoles f…
- Macro Deck: Transforms a mobile device into a WiFi or USB-connected macro pad for organizing custom shortcuts, PC app controls, streaming functions, an…
- TouchPortal: Touch Portal is a companion app to control a PC or a Mac by using a deck of buttons to improve the workflow &amp; productivity of game stre…

---
Source: Our Local Host (https://ourlocalhost.com/app/2661/bitfocus-companion), the self-hosted and open-source app directory.
