Maschine Emulator: DO NOT USE WEB MIDI

Comprehensive technical design document: analysis of the Native Instruments Maschine controller communication (MIDI mode message maps, known HID/NI protocol details from public reverse-engineering efforts), evaluation of virtual MIDI port strategies on Windows (teVirtualMIDI, loopMIDI interop, Windows MIDI Services), .NET library selection (NAudio.Midi / DryWetMIDI / Win32 winmm interop), overall app architecture (input layer, translation engine, virtual output, UI), threading model for low-latency MIDI, and a risk register covering NI proprietary protocol limitations with fallback plans.

C# .NET class library implementing physical MIDI device enumeration, hot-plug detection, low-latency input listening and raw message parsing (note on/off, CC, program change, pitch bend, sysex, MIDI clock) using native Windows MIDI APIs — explicitly no Web MIDI. Includes message abstraction types, ring-buffered input queue, timestamping, unit tests with simulated device streams, and developer documentation.

Output layer that presents an emulated Maschine-compatible MIDI device to the host: integration wrapper for virtual MIDI port drivers, device naming/identity handling so DAWs and the Maschine software recognize the port, outbound message scheduler, sysex passthrough, feedback channel for receiving host messages back (LED/state echo), error recovery on port loss, plus setup documentation for the required virtual MIDI driver and automated integration tests using loopback ports.

The core mapping engine translating arbitrary incoming controller messages into Maschine-equivalent output: declarative mapping schema (JSON) defining source (channel/type/number/range) to target (Maschine pad, encoder, button, transport function), value transforms (scaling, inversion, toggle vs momentary, relative encoder modes), conditional layers/shift states, and conflict resolution. Fully unit-tested with an extensive fixture suite of message translation cases.

Behavioral logic for the emulated Maschine surface: transport controls (play, stop, record, loop, tempo tap, metronome), 16-pad grid with velocity curves and fixed-velocity mode, pad banks, group/scene/pattern navigation buttons, encoder handling for browse/volume/swing, shift-layer combinations, and MIDI clock sync handling. Includes a state machine implementation with tests covering all mode transitions and edge cases like stuck notes and double-triggers.

Interactive MIDI-learn subsystem: listen mode that captures the next incoming message and binds it to a selected Maschine function, smart detection of message type (absolute CC, relative encoder, note, toggle button), per-control range calibration, plus ready-made mapping profiles for popular modern USB-C controllers (Akai MPK Mini MK3, Arturia MiniLab 3, Novation Launchkey MK3/Launchpad X, AKAI MPD218) shipped as JSON presets with documentation for each.

Windows WPF application shell: device selection panels (physical input, virtual output), visual Maschine surface representation showing pad/button/transport activity in real time, mapping editor grid with MIDI-learn buttons, live MIDI monitor/log view, status bar with connection and clock state, dark theme styling consistent with music software, MVVM architecture with view models wired to the engine, and keyboard accessibility.

Configuration subsystem: app settings persistence (last devices, latency options, startup behavior), mapping profile save/load/import/export as JSON files, profile versioning and migration, auto-reconnect of last-used devices on launch, portable vs installed config paths, crash-safe atomic file writes, and unit tests for serialization round-trips and corrupt-file recovery.

Reliability tooling: structured logging with rolling files, in-app diagnostics panel (message throughput, latency measurements, dropped-message counters), a MIDI loopback self-test wizard, a headless test harness that replays recorded controller sessions through the full pipeline for regression testing, stress tests for high message rates, and a bug-report bundle exporter (logs + config + system info).

Release engineering and docs: .NET publish configuration (self-contained win-x64 build), installer script (Inno Setup or MSIX) including guided virtual-MIDI-driver setup step, code signing/build pipeline instructions, comprehensive user manual (getting started, connecting your controller, mapping guide, using with Maschine software and DAWs), troubleshooting FAQ (port conflicts, driver issues, latency tuning), and a README with screenshots plus contribution guide.