From fa1d048e5d8c87c3dcd6f1695d95d6de1d2ce7f3 Mon Sep 17 00:00:00 2001
From: "push-app-to-main[bot]"
 <203845782+push-app-to-main[bot]@users.noreply.github.com>
Date: Wed, 20 May 2026 07:41:23 +0000
Subject: [PATCH] Add bitfocus-companion (ct)

---
 ct/bitfocus-companion.sh              | 70 +++++++++++++++++++++++++++
 ct/headers/bitfocus-companion         |  6 +++
 install/bitfocus-companion-install.sh | 68 ++++++++++++++++++++++++++
 3 files changed, 144 insertions(+)
 create mode 100644 ct/bitfocus-companion.sh
 create mode 100644 ct/headers/bitfocus-companion
 create mode 100644 install/bitfocus-companion-install.sh

diff --git a/ct/bitfocus-companion.sh b/ct/bitfocus-companion.sh
new file mode 100644
index 000000000..d668f2893
--- /dev/null
+++ b/ct/bitfocus-companion.sh
@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func)
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: glabutis
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://github.com/bitfocus/companion
+
+APP="Bitfocus-Companion"
+var_tags="${var_tags:-automation;media}"
+var_cpu="${var_cpu:-2}"
+var_ram="${var_ram:-512}"
+var_disk="${var_disk:-8}"
+var_os="${var_os:-debian}"
+var_version="${var_version:-12}"
+var_unprivileged="${var_unprivileged:-1}"
+
+header_info "$APP"
+variables
+color
+catch_errors
+
+function update_script() {
+  header_info
+  check_container_storage
+  check_container_resources
+
+  if [[ ! -f /opt/bitfocus-companion/companion_headless.sh ]]; then
+    msg_error "No ${APP} Installation Found!"
+    exit 1
+  fi
+
+  RELEASE_JSON=$(curl -fsSL "https://api.bitfocus.io/v1/product/companion/packages?limit=20")
+  PACKAGE_JSON=$(echo "$RELEASE_JSON" | jq -c '(if type == "array" then . else .packages end) | [.[] | select(.target=="linux-tgz" and (.uri | contains("linux-x64")))] | first')
+  RELEASE=$(echo "$PACKAGE_JSON" | jq -r '.version // empty')
+  ASSET_URL=$(echo "$PACKAGE_JSON" | jq -r '.uri // empty')
+  if [[ -z "$RELEASE" || -z "$ASSET_URL" ]]; then
+    msg_error "Could not resolve a matching Linux x64 Companion package from the Bitfocus API."
+    exit 1
+  fi
+
+  if [[ "${RELEASE}" == "$(cat ~/.bitfocus-companion 2>/dev/null)" ]]; then
+    msg_ok "No update required. ${APP} is already at v${RELEASE}"
+    exit
+  fi
+
+  msg_info "Stopping ${APP}"
+  systemctl stop bitfocus-companion
+  msg_ok "Stopped ${APP}"
+
+  msg_info "Updating ${APP} to v${RELEASE}"
+  CLEAN_INSTALL=1 fetch_and_deploy_from_url "$ASSET_URL" "/opt/bitfocus-companion"
+  echo "${RELEASE}" >~/.bitfocus-companion
+  msg_ok "Updated ${APP} to v${RELEASE}"
+
+  msg_info "Starting ${APP}"
+  systemctl start bitfocus-companion
+  msg_ok "Started ${APP}"
+
+  msg_ok "Update Successful"
+  exit
+}
+
+start
+build_container
+description
+
+msg_ok "Completed successfully!\n"
+echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}"
+echo -e "${INFO}${YW} Access it using the following URL:${CL}"
+echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:8000${CL}"
diff --git a/ct/headers/bitfocus-companion b/ct/headers/bitfocus-companion
new file mode 100644
index 000000000..56521d7b4
--- /dev/null
+++ b/ct/headers/bitfocus-companion
@@ -0,0 +1,6 @@
+    ____  _ __  ____                            ______                                  _           
+   / __ )(_) /_/ __/___  _______  _______      / ____/___  ____ ___  ____  ____ _____  (_)___  ____ 
+  / __  / / __/ /_/ __ \/ ___/ / / / ___/_____/ /   / __ \/ __ `__ \/ __ \/ __ `/ __ \/ / __ \/ __ \
+ / /_/ / / /_/ __/ /_/ / /__/ /_/ (__  )_____/ /___/ /_/ / / / / / / /_/ / /_/ / / / / / /_/ / / / /
+/_____/_/\__/_/  \____/\___/\__,_/____/      \____/\____/_/ /_/ /_/ .___/\__,_/_/ /_/_/\____/_/ /_/ 
+                                                                 /_/                                
diff --git a/install/bitfocus-companion-install.sh b/install/bitfocus-companion-install.sh
new file mode 100644
index 000000000..22c976306
--- /dev/null
+++ b/install/bitfocus-companion-install.sh
@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: glabutis
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://github.com/bitfocus/companion
+
+source /dev/stdin <<<"$FUNCTIONS_FILE_PATH"
+color
+verb_ip6
+catch_errors
+setting_up_container
+network_check
+update_os
+
+msg_info "Installing Dependencies"
+$STD apt install -y libusb-1.0-0
+msg_ok "Installed Dependencies"
+
+msg_info "Fetching Latest Bitfocus Companion Release"
+RELEASE_JSON=$(curl -fsSL "https://api.bitfocus.io/v1/product/companion/packages?limit=20")
+PACKAGE_JSON=$(echo "$RELEASE_JSON" | jq -c '(if type == "array" then . else .packages end) | [.[] | select(.target=="linux-tgz" and (.uri | contains("linux-x64")))] | first')
+RELEASE=$(echo "$PACKAGE_JSON" | jq -r '.version // empty')
+ASSET_URL=$(echo "$PACKAGE_JSON" | jq -r '.uri // empty')
+if [[ -z "$RELEASE" || -z "$ASSET_URL" ]]; then
+  msg_error "Could not resolve a matching Linux x64 Companion package from the Bitfocus API."
+  exit 1
+fi
+msg_ok "Found Companion ${RELEASE}"
+
+fetch_and_deploy_from_url "$ASSET_URL" "/opt/bitfocus-companion"
+
+msg_info "Installing udev Rules"
+if [[ -f /opt/bitfocus-companion/50-companion-headless.rules ]]; then
+  cp /opt/bitfocus-companion/50-companion-headless.rules /etc/udev/rules.d/
+  udevadm control --reload-rules
+  udevadm trigger
+fi
+msg_ok "Installed udev Rules"
+
+mkdir -p /opt/bitfocus-companion-config
+
+msg_info "Creating Service"
+cat <<EOF >/etc/systemd/system/bitfocus-companion.service
+[Unit]
+Description=Bitfocus Companion
+After=network.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+ExecStart=/opt/bitfocus-companion/companion_headless.sh --config-dir /opt/bitfocus-companion-config
+WorkingDirectory=/opt/bitfocus-companion
+Restart=on-failure
+RestartSec=5
+Environment=NODE_ENV=production
+
+[Install]
+WantedBy=multi-user.target
+EOF
+systemctl enable -q --now bitfocus-companion
+msg_ok "Created Service"
+
+echo "${RELEASE}" >~/.bitfocus-companion
+
+motd_ssh
+customize
+cleanup_lxc