Skip to content

[CoreMidiSample] Add CoreMIDI sample project. #10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
rolfbjarne wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

[CoreMidiSample] Add CoreMIDI sample project. #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 61 additions & 0 deletions CoreMidiSample/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# CoreMIDI Sample

This sample demonstrates the CoreMIDI framework bindings for .NET, including both legacy and modern (MIDI 2.0/UMP) APIs.

## Features Demonstrated

### Device Enumeration
- Enumerate all MIDI devices, entities, and endpoints
- List external devices
- Find objects by unique ID
- Get dictionary properties

### Virtual Endpoints
- Create virtual MIDI sources (legacy and protocol-based)
- Create virtual MIDI destinations (legacy and protocol-based)
- Create input and output ports
- External device management (create, add, remove)

### MIDI Data (Legacy)
- Create `MidiPacket` instances with raw byte data
- Packet construction with byte arrays and ranges

### MIDI Data (Modern / UMP)
- Create `MidiEventList` with Protocol 1.0 and 2.0
- Add Universal MIDI Packets (UMP) to event lists
- Iterate packets using `IEnumerable<MidiEventPacket>` and zero-copy `Iterate` callback
- Handle timestamp-based packet merging
- Work with `MidiEventPacket` structs

### Happy Birthday Melody
- Complete "Happy Birthday to You" encoded as MIDI 1.0 UMP messages
- Demonstrates Note On/Off creation, timestamp management, and iteration

### MIDI 2.0 Structs
- `Midi2DeviceManufacturer` - manufacturer SysEx IDs
- `Midi2DeviceRevisionLevel` - device revision levels
- `MidiCIProfileId` - standard and manufacturer-specific CI profiles
- `MidiBluetoothDriver` - Bluetooth MIDI connection management

## Requirements

- macOS 14.0 or later
Copy link

Copilot AI Feb 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

README states “macOS 14.0 or later”, but the project sets <SupportedOSPlatformVersion>15.0</SupportedOSPlatformVersion>. Please align the README requirements with the actual project minimum (or lower the project minimum if 14.0 is intended).

Suggested change
- macOS 14.0 or later
- macOS 15.0 or later

Copilot uses AI. Check for mistakes.
- .NET 10.0 (preview) with the macOS workload installed
- Requires the updated CoreMIDI bindings (MidiEventList, MidiDevice.Create, MidiSetup, etc.)
that ship with .NET for iOS/macOS after the CoreMIDI update from
[dotnet/macios#4452](https://github.com/dotnet/macios/issues/4452) and
[dotnet/macios#12489](https://github.com/dotnet/macios/issues/12489).

## Building

```bash
cd macOS
dotnet build
dotnet run
```

To immediately play Happy Birthday through the speakers on launch:

```bash
dotnet run -- --play-happy-birthday
```
Loading