v0.1.0 — First Release

push2-bridge v0.1.0

First release of the VDMX → Syphon → Push 2 display bridge for macOS.

Features

• Syphon receiver — auto-discovers VDMX's Syphon server, reconnects on drop
• Frame converter — resizes to 960×160, BGRA→BGR565 native path for max throughput
• Push 2 display driver — USB bulk transfer via push2-python
• Bridge loop — orchestrates the full pipeline with FPS capping and keep-alive
• CLI — push2-bridge command with configurable FPS, Syphon server, fallback color, and interpolation mode
• Error recovery — handles USB disconnects, Syphon drops, and clean shutdown on Ctrl+C
• Benchmark script — scripts/benchmark.py for profiling frame conversion

Performance

Format	FPS
BGR565 (default)	~36 fps
RGB565	~14 fps
RGB float	~14 fps

Install

brew install libusb
pip install git+https://github.com/joaodotwork/push-2-led.git

Requirements

• macOS 11+ (Big Sur or later)
• Python 3.9+
• Ableton Push 2 connected via USB
• Close Ableton Live before running (only one app can access the display)

Quick Start

# Set up a Syphon output named "Push2" at 960×160 in VDMX, then:
push2-bridge

See the README for full CLI options and VDMX setup instructions.