Skip to content

Bitfocus Companion enables the reasonably priced Elgato Streamdeck to be a professional shotbox surface for an increasing amount of different presentation switchers, video playback software and broadcast equipment.

License

Notifications You must be signed in to change notification settings

poulhoi/companion-pi-itustudios

 
 

Repository files navigation

CompanionPi is a prebuilt image for the Raspberry Pi 4B, setup to run Bitfocus Companion

This repository houses the tooling for building the images, only issues relating to the image building/updating should be reported here.

This also works on other headless Debian or Ubuntu machines.

Companion Pi

Prebiult images can be found on the Bitfocus website

Note: This has been written for arm64 images, and is not tested or supported on anything below a 4B. We do not recommend running it on anything lower, but you can follow the manual install instuctions if you are sure you want to.

Other Debian/Ubuntu

No images are provided for this, but the process has been written to be a single script.

As root, run the following:

curl https://raw.githubusercontent.com/bitfocus/companion-pi/main/install.sh | sh

After this, you can use sudo companion-update to change the version it has installed.

Note: This script will create a new user called companion, which Companion will be run as and will own the configuration.

Development

Warning: This has only been tested on linux, but it should work wherever packer is supported.

This repository utilises packer to build images, using an arm-image plugin to add to an official raspberry-pi-lite image.

After installing packer, set it up for this project: packer init companionpi.pkr.hcl.

You can then perform the build with packer build --var branch=master companionpi.pkr.hcl. Be aware that this can be very slow, due to the cpu architecture emulation.

Once complete, the file output-companionpi/image can be written to an sd card and launched on a pi

About

Bitfocus Companion enables the reasonably priced Elgato Streamdeck to be a professional shotbox surface for an increasing amount of different presentation switchers, video playback software and broadcast equipment.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 48.3%
  • JavaScript 44.1%
  • HCL 7.6%