About this project

MPCTK enables users to programmatically generate and edit Akai MPC Sample projects using Python. It reads and writes gzip-compressed .xpj files, injects WAV samples into projects, and automatically creates the required _[ProjectData] directory. Users can generate chromatic or scale-based pad layouts (major/natural minor), transpose from source to target roots, clone layers between pads, and adjust coarse tuning. Projects are validated on actual MPC Sample hardware. The current MVP requires an XPJ template file and uses real-time tuning rather than rendered audio. CLI-driven with no GUI. Future work includes automatic root detection, multi-bank support, and embedded templates. Installation via pip in editable mode; requires Python 3.11+.