OctoPrint-BitBang 0.1.6

Remote OctoPrint access with live H.264 video via BitBang WebRTC

OctoPrint-BitBang

This is an OctoPrint plugin that offers full remote access to your OctoPrint instance including live H.264 video over a single HTTPS shareable link. It uses BitBang which creates a secure, fast peer-to-peer connection that requires no account, no subscription, port forwarding, tunnel, or VPN.

This is part of the BitBang project.

What you get

• Full remote access: You get full access from anywhere through a secure HTTPS URL. Configure, upload G-code, start jobs, see live video, etc.
• One link, no account set-up: Remote access, share the URL, share your printer.
• Live H.264 video: Frames come straight from the camera, hardware-encoded on Pi 4 (/dev/video11 V4L2 M2M) and software-encoded on Pi 5 or any other Linux host, then packetized by aiortc and delivered as a WebRTC media stream. CPU footprint is around 40% (single core) on Pi4.
• BitBang URL access is optional: Video streaming works with local access through local network URL also.
• Pi CSI camera or USB webcam: Auto-detected (IMX477, IMX219, IMX708, or any V4L2-capable USB webcam).
• Camera controls: Camera selection, live brightness slider, fullscreen button, image flip H/V buttons, and resolution selection (VGA up to 720p).
• Snapshots and timelapse: Integrates with OctoPrint's WebcamProviderPlugin API -- snapshots are grabbed from the live stream, so no second camera pipeline to configure.
• Mobile friendly: BitBang URL works with phones/tablets.
• PIN protection: Optional PIN required to access the remote URL.

Installation

Plugin Manager (recommended, once accepted into the OctoPrint plugin registry)

In OctoPrint: Settings → Plugin Manager → Get More, search for BitBang, click Install.

Plugin Manager, install from URL

Settings → Plugin Manager → Get More → "… from URL", then paste:

https://github.com/richlegrand/OctoPrint-BitBang/archive/main.zip

Click Install, then restart OctoPrint when prompted.

pip

Inside your OctoPrint venv:

pip install OctoPrint-BitBang

Restart OctoPrint.

Usage

1. If you are using a separate program for camera streaming (e.g. camera-streamer, mjpg-streamer, ustreamer) you should stop these processes before running BitBang plugin to avoid camera access contention. See commands below.

Stable octopi stack:

sudo systemctl stop webcamd
sudo systemctl stop ffmpeg_hls
sudo systemctl disable webcamd
sudo systemctl disable ffmpeg_hls

New camera stack:

sudo systemctl stop camera-streamer
sudo systemctl disable camera-streamer

2. Point your browser to your local OctoPrint server. Open Settings → BitBang.
3. Choose camera from dropdown.

4. Choose resolution.

5. Set a PIN (Optional).
6. Save and restart OctoPrint.
7. Refresh the OctoPrint tab in your browser. A button labeled BitBang is available in the menu bar -- click it for the URL.

This URL allows remote access to your printer.

Configuration

All settings live in Settings → BitBang:

Setting	Effect
Enabled	Toggle BitBang remote access
PIN	Optional 4+ digit PIN prompt on the remote URL
Camera	Auto-detect, or select from dropdown list
Resolution	VGA → HD (depending on what selected camera supports)
Flip horizontal / vertical	Flip video if necessary

All settings take effect on OctoPrint restart. Full-screen button and brightness slider are overlaid on the video window (Control tab) and update immediately.

How it works

• The bitbang-python package handles WebRTC signaling, identity, and the ASGI interface.
• This plugin wraps it with OctoPrint integration: settings UI, WebcamProviderPlugin hooks, camera auto-detect, CSRF-safe cookie handling, and the JavaScript that injects the <video> element into OctoPrint's Control tab.
• The bitba.ng cloud acts purely as a signaling relay to broker a direct connection. If a direct connection isn't available, bitba.ng will use TURN instead.

Privacy

The BitBang plugin connects through the bitba.ng cloud signaling service to broker peer-to-peer connections. Here is what bitba.ng does and does not see:

• Signaling: When the plugin starts, it registers with bitba.ng using a public key derived from a locally-generated keypair (the private key never leaves your device). bitba.ng sees this public key, the derived UID that becomes part of your URL, and connection metadata (timestamps, IPs of peers attempting to connect).
• Media path: Once a peer connects, video and HTTP traffic flow directly between the browser and your OctoPrint host over an encrypted WebRTC data channel (DTLS-SRTP). bitba.ng does not see this traffic.
• TURN fallback: If a direct connection cannot be established (strict NAT/firewall), bitba.ng may relay the encrypted WebRTC stream via TURN. Even in that case, the relay sees ciphertext only — it cannot decrypt your video, OctoPrint UI, or credentials.
• No account, no tracking: The plugin does not create an account, send telemetry, or upload usage data.
• Access control: Anyone with your URL can reach your OctoPrint instance. Set a PIN in the plugin settings to require a passcode on the remote URL.

See the BitBang project page for the full signaling protocol and identity specifications.

Supported hardware

• Raspberry Pi 4 -- hardware H.264 on Pi 4 via V4L2 M2M; tested with IMX477, IMX219
• Raspberry Pi 5 -- software H.264 via picamera2's LibavH264Encoder; 720p@30 comfortably
• Generic Linux PC/laptop/SBC with webcam -- software H.264 via aiortc
• USB webcams -- any device that offers a V4L2 capture format; aiortc software-encodes to H.264

Software requirements

Live video uses PyAV (Python bindings for FFmpeg) via aiortc. Two pieces need to line up at runtime:

• FFmpeg 7.x runtime (libavformat.so.61 and friends). On Raspberry Pi OS Bookworm or newer: sudo apt install ffmpeg. Older releases ship FFmpeg 5/6 — install via backports or build from source.
• 64-bit OS recommended. PyAV ships prebuilt wheels with bundled FFmpeg for 64-bit Linux (aarch64) and macOS; 32-bit ARM (armv7l) has no wheel and pip must source-build, which is fragile if the system FFmpeg version doesn't match. OctoPi 1.1.0+ is 64-bit by default. 32-bit installs can work but typically need a manual FFmpeg 7 install first.

If the video stack can't be initialized, the plugin still loads in diagnostic mode -- it appears in OctoPrint with a clear log line in octoprint.log (look for BitBang video stack unavailable) so you can see exactly what's missing. Video and BitBang remote URL access stay disabled until the underlying dependency is resolved.

License

MIT. See LICENSE.

Credits

Built on aiortc, picamera2, and the bitbang-python library. Plugin scaffold uses OctoPrint's plugin API.

Contributing

Issues and PRs are welcome.