Skip to content

README.md

Latest commit

 

History

History
30 lines (19 loc) · 1.24 KB

README.md

File metadata and controls

30 lines (19 loc) · 1.24 KB

push3-protocol-docs

Reverse-engineered protocol documentation for the Ableton Push 3. Ableton publishes no official API - this covers the USB display protocol, MIDI mapping, pad sensitivity curves, SysEx commands, MPE, and audio interface configuration.

Docs

  • Quickstart - open ports, enter User Mode, light a pad, log presses
  • Display Protocol - USB framebuffer, encryption, image prep, sending frames
  • Button Mapping - all 70+ buttons with CC values
  • Encoder Mapping - 10 encoders, touch detection, rotation values, touch strip
  • SysEx Protocol - pad sensitivity curves, MPE, touch strip modes, audio interface

Tools

Research and testing scripts in tools/. Requires pyusb, pillow, mido, python-rtmidi.

  • display_test.py - push an image to the display
  • text_renderer.py - generate display frames with text
  • midi_monitor.py - log incoming MIDI in real time
  • midi_test.py - test LED output and SysEx

See tools/README.md for setup and usage.

Cheers.

Push 2 information references DrivenByMoss and Ableton's official Push 2 documentation.