scott 7415590fba
Some checks failed
Docker Build and Publish / Build Docker image and publish to Gitea (push) Failing after 58s
Add Gitea Actions workflow to build and publish Docker image
Builds on push to main and publishes to git.sdgarren.com container registry.
Requires REGISTRY_USERNAME and REGISTRY_TOKEN repo secrets.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-07 12:36:26 -04:00

usb-crash-cart

Docker container wrapper for the NOTECONS02 USB Crash Cart Adapter software.

The vendor software (usb-crash-cart-adapter v20240517) was built against Ubuntu 16.04 (Python 2.7, wxWidgets 2.9/GTK2) and is incompatible with modern Fedora. This repo runs it inside an Ubuntu 16.04 container with X11 passthrough.

Setup

1. Install udev rules (once, on the host)

sudo ./install-udev-rules.sh

This allows the crash cart adapter (USB vendor 152a, products 8460/8463) to be accessed without root.

2. Place the .deb package

Copy the vendor .deb to packages/crash-cart.deb:

cp /path/to/"Linux-X64 Crash Cart Software_1240415.deb" packages/crash-cart.deb

3. Build the image

docker build -t usb-crash-cart .

4. Run

./docker-run.sh

This handles X11 socket sharing and USB device passthrough automatically.

Notes

  • The container uses ubuntu:16.04 to match the build environment.
  • The app bundles its own libpython2.7, libwx_gtk2u-2.9, libpng12, etc. — the container only needs GTK2 and X11 system libs from the OS.
  • LD_LIBRARY_PATH is set to prefer the bundled libs over system ones.
  • The .deb is excluded from git (.gitignore) — obtain it from the vendor package.
Description
Docker container wrapper for the NOTECONS02 USB Crash Cart Adapter software (Ubuntu 16.04 base with X11/XWayland passthrough)
Readme 22 MiB
Languages
Shell 65.6%
Dockerfile 34.4%