XPI remains free, MIT-licensed, and fully usable without payment. If the native gamepad-to-MIDI/MPE app is useful to you, you can make an optional £10 one-time contribution to support its continued development.

Become an XPI Early Supporter — £10

This is a voluntary supporter contribution, not a paid software licence or a promise of new features, support, or early-access privileges. The same alpha downloads and source remain available to everyone.

Pre-built native macOS universal releases are packaged directly via GitHub Actions CI.

Validated release build introducing real-time interactive guided tutorials (Learn Hub), continuous harmonic drone pad play mode with delta-morphing sustain, the 16-scheme "Ways to Play" quick switcher gallery, integrated arpeggiator engine, MIDI Learn in Map workspace, and strengthened concurrency guarantees:

• Recommended: Download XPadInput-0.0.05.dmg
• Fallback ZIP: Download XPadInput-0.0.05.zip
• Full Release Notes: See CHANGELOG.md

SHA-256:

481437081014a218e4e9fe1fdf73e5af137284d2fe987fa55e9b41a6f36e3e34  XPadInput-0.0.05.dmg
344f09e3c0758bcee354c8d65fa1b784a1b65f1ad804a7b5820188a25dba4ef8  XPadInput-0.0.05.zip

• Download XPadInput-0.0.04.dmg
• Download XPadInput-0.0.04.zip

• Download XPadInput-0.0.03.dmg
• Download XPadInput-0.0.03.zip

• Download XPadInput-0.0.02.dmg
• Download XPadInput-0.0.02.zip

• Download XPadInput-0.0.01.dmg
• Download XPadInput-0.0.01.zip
• View GitHub Prerelease

1. Download and open the DMG.
2. Drag XPI: Game Controller MIDI to Applications.
3. Connect a supported controller over Bluetooth or USB.
4. Launch XPI: Game Controller MIDI.
5. If macOS blocks first launch for an unsigned alpha, right-click the app in Applications and choose Open.

Please test controller detection, analog sticks, triggers, chord selection, virtual strumming, internal synth, MIDI/MPE routing, and disconnect/reconnect resilience. Report issues at GitHub Issues.

Alpha Notice: XPI is under active development. Mappings, UI controls, and MIDI features evolve rapidly.

• Polar Harmonic Mapping: Left analog stick sweeps through harmonic space with real-time Circle of Fifths orientation.
• 5 Dynamic Harmonic Layers:
  • 🟢 Diatonic: Natural scale chords (I, ii, iii, IV, V, vi, vii°).
  • 🔵 Colour / Extensions: Rich 7ths, 9ths, and sus chords.
  • 🟣 Modal Interchange: Chords borrowed from parallel Aeolian, Dorian, and Phrygian modes.
  • 🟠 Tension & Secondary Dominants: V7/V, V7/vi, and tritone substitutions (subV7).
  • 🔴 Chromatic Mediants: Film-score emotional shifts (♭III, III, ♭VI, VI).
• Harmonic Risk Radius: Radial deflection ($r$) expands chord extensions and tension.

• Physical Velocity Dynamics: Right analog stick crossing virtual string thresholds triggers note-on events.
• Natural Strum Speed: Swipe velocity dynamically modulates note velocity and string spread arpeggiation delay (2ms–35ms).
• Direction Awareness: Down-strums and up-strums automatically trigger proper bottom-to-top or top-to-bottom voice excitation.
• Palm Mute & Dampening: Progressive analog trigger (L2/R2) dampens string vibrations in real time.

• Pianistic Voice Leading: Minimal voice displacement heuristics prevent large register leaps and anchor common tones.
• Strategies: Smooth (Minimal Motion), Piano (SATB), Bass Anchored, Cinematic (Open Spread), Parallel.
• "What Next?" AI Suggestions: Ranked next-chord recommendations across 8 categories (Familiar, Smooth, Resolution, Colourful, Darker, Brighter, Cinematic, Outside).
• Modulation Navigator: Automatic generation of ii–V–I dominant cycles, pivot chords, and chromatic mediant transition pathways.

• Native CoreMIDI Virtual Ports:
  • XPI Main
  • XPI Chords
  • XPI Melody
  • XPI Bass
  • XPI Drums
  • XPI Expression (MPE)
• MPE Zone Distribution: Independent per-note voice allocation across Channels 2–16 for DAW MPE hosts (2–15 for the internal synth).
• Multi-Dimensional Expression:
  • Pitch Bend: 6-axis gyro tilt or stick deflection ($\pm 48$ semitones).
  • Polyphonic Pressure (Z-Axis): Trigger travel / aftertouch.
  • Timbre CC74 (Y-Axis): Capacitive touchpad or vertical stick deflection.
• Experimental MIDI 2.0 UMP Transport: Selectable Universal MIDI Packet transport supporting native 32-bit pitch bend, high-resolution pressure, and 32-bit CC74 with automated CoreMIDI virtual-source loopback verification.

• Built with AVAudioEngine and custom low-latency AVAudioSourceNode C-callbacks.
• PolyBLEP bandlimited oscillators (Sawtooth, Square, Triangle, Sine), ADSR envelope generators, and resonant state-variable filters.
• Factory Presets: Poly Lead, Rhodes Electric Piano, Lush Ambient Pad, Acoustic Pluck, Sub Bass.

• Multi-track clip timeline supporting Chords, Melody, Bass, Drums, and Gesture automation.
• Real-time gesture recording (GestureRecorder) capturing stick trajectories and gyro motion.
• One-click Standard MIDI File (.mid) export with native drag-and-drop directly into Ableton Live, Logic Pro, Bitwig Studio, or Finder.

• Interactive lessons for mastering chord progressions and harmonic movement.
• Real-time chord evaluation with timing accuracy feedback.
• Progress tracking with session history and improvement metrics.

• AUv3 MIDI FX & Instrument: Package XPI as an Audio Unit v3 plugin for direct hosting inside Logic Pro, Ableton Live, Bitwig Studio, and Cubase.
• Virtual Audio Driver: Direct virtual loopback audio stream for zero-configuration system audio capture.
• Built-in Drums: Dedicated drum synthesis engine for rhythm production.

• Real-time binaural spatial audio rendering with head-related transfer function (HRTF) processing.
• 3D audio positioning for immersive performance experience.

• 7 Built-in Control Schemes: Performance (default), Classic, Low-Fatigue, Left-Handed, One-Hand Left, One-Hand Right, Custom.
• Semantic Musical Action Layer: Decouples physical inputs from instrument profiles for flexible remapping.
• Runtime Remapping: ControlSurfaceResolver projects bindings onto canonical performance layout.

• Open-source JSON schema for community controller mapping profiles.
• Visual 3D skinning support for niche controllers.

• macOS 14.0 (Sonoma) or macOS 15.0+ (Sequoia)
• Supported game controller (DualSense, Xbox, Switch Pro, or generic MFi)
• Apple Silicon or Intel Mac

# Clone the repository
git clone https://github.com/sp80808/XPadInput.git
cd XPadInput

# Build the macOS application
swift build

# Run the branded application
swift run XPI

# Run standard test suite
swift test

# Run exhaustive test runner
swift run XPadTests

XPI Auto-Detect (MAP → MIDI Translation) applies these channel maps from the frontmost macOS DAW. A filtered DAW track channel (1–16) collapses pitched roles onto that channel and turns MPE off so notes are not dropped.

1. Launch XPI and connect your controller.
2. Open Ableton Live Settings $\rightarrow$ Link/MIDI.
3. Under MIDI Inputs, enable Track and Remote for XPI Main or XPI Chords.
4. In your MIDI Track, set MIDI From $\rightarrow$ XPI Expression (MPE) and enable MPE Mode in a compatible instrument (e.g. Wavetable, Drift, Sampler).

1. Create a Software Instrument track (e.g. Alchemy, Studio Strings, Retro Synth).
2. In Track Inspector, select MIDI Input Port: XPI Chords or XPI Expression (MPE).
3. In instrument settings, enable MPE mode for multi-channel pitch bend and pressure.
4. To test experimental MIDI 2.0, enable the MIDI 2.0 preference in Logic Pro settings.

1. In Bitwig Settings $\rightarrow$ Controllers, add an MPE controller targeting XPI Expression (MPE).
2. Route member channels directly into Polymer, Phase-4, or The Grid.

XPadInput/
├── Package.swift              # Swift Package Manager manifest
├── Sources/
│   ├── XPadCore/              # Pure 12-TET theory primitives (PitchClass, Note, Scale, Chord)
│   ├── XPadTheory/            # Harmonic wheel, voice leading, suggestions & progressions
│   ├── XPadPractice/          # Practice mode for chord progression learning
│   ├── XPadController/        # GCController abstraction, virtual strummer & gesture DSP
│   ├── XPadMIDI/              # CoreMIDI virtual ports, MPE zone manager & SMF exporter
│   ├── XPadAudio/             # PolyBLEP DSP synthesizer, AUv3 plugin & virtual audio driver
│   ├── XPadSequencer/         # 960 PPQN tick clock, clips, tracks & scenes
│   ├── XPadUI/                # Native SwiftUI 6-workspace desktop interface
│   ├── XPadInput/             # Application main entrypoint
│   └── XPadTests/             # Universal exhaustive test runner (executable target)
├── Tests/
│   ├── XPadCoreTests/         # Unit tests for theory primitives
│   ├── XPadTheoryTests/       # Unit tests for harmony engine
│   ├── XPadPracticeTests/     # Unit tests for practice mode
│   ├── XPadControllerTests/   # Unit tests for controller abstraction
│   ├── XPadMIDITests/         # Unit tests for CoreMIDI & MPE
│   ├── XPadAudioTests/        # Unit tests for DSP synth
│   └── XPadSequencerTests/    # Unit tests for timeline engine
├── docs/                      # Central documentation directory
│   ├── README.md              # Documentation hub index
│   ├── guides/                # Getting started, controller setup, AUv3 plugin & MPE guides
│   ├── architecture/          # Architecture overview, tech stack & design specifications
│   ├── hardware/              # Controller feature matrix & hardware support
│   ├── specifications/        # MIDI/MPE specification & instrument techniques contract
│   └── roadmap/               # Product roadmap, MIDI 2.0 specs, improvements & research
├── .github/workflows/         # Automated macOS CI & packaging workflow (macos-ci.yml)
├── .agents/skills/            # Specialized agent skills and workflow guides
├── AGENTS.md                  # Agent operating instructions and modular rules
├── CHANGELOG.md               # Version history and detailed changelogs
├── SOUL.md                    # Philosophical and artistic instrument manifesto
└── README.md                  # Project documentation and entrypoint guide

MIT License. Crafted for musicians, beatmakers, and performers.

1. Fork the repository and create a feature branch from main.
2. Follow the module conventions in AGENTS.md — pure theory in XPadCore/XPadTheory, no audio/UI dependencies in core modules.
3. Run swift test before committing; all test suites must pass.
4. Keep commits semantic: feat:, fix:, refactor:, test:, docs:.
5. Purge ._* AppleDouble files before committing.
6. Open a PR with a clear description of the musical or technical motivation.