scott bf1ce4b70e Add vendor .deb package to packages/
Includes crash-cart.deb (Linux-X64 Crash Cart Software_1240415.deb) so the
Docker image can be built without needing to source the file separately.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-07 12:33:01 -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%