midiex

# Changelog

## 0.6.4 (2026-06-09) - includes breaking changes
This release:
- **[Breaking change]** Modifies the Rust code to return MIDI data in binary format (e.g. `<<153, 60, 70>>`), rather than a list (e.g. `[153, 60, 70]`). See [issue #10](https://github.com/haubie/midiex/issues/10) for more information. Thank you to [@Rashidwi](https://github.com/Rashidwi) and [@nseaSeb](https://github.com/nseaSeb) for raising it. If you'd prefer the old behavior, you can use `:binary.bin_to_list/1` to convert the binary data back to a list, e.g.:
```elixir
binary = <<153, 60, 70>>
list = :binary.bin_to_list(binary)
#=> [153, 60, 70]
```
- **[Breaking change]** Unifies the subscription API for virtual inputs. Subscribing to a `%Midiex.VirtualMidiPort{}` now returns a `%Midiex.MidiMessage{}` struct rather than a raw byte list.
- **Polymorphic port structs**: the `port` field inside `%Midiex.MidiMessage{}` is now polymorphic and type-safe. It will contain either a `%Midiex.MidiPort{}` (for physical/OS device ports) or a `%Midiex.VirtualMidiPort{}` (for custom virtual inputs). This allows for clean, idiomatic pattern matching in your Elixir handlers:
```elixir
# Handle messages from physical keyboard
def handle_msg(%MidiMessage{port: %Midiex.MidiPort{name: "KeyStep Pro"}, data: data}) do
  ...
end

# Handle messages from your custom virtual synth
def handle_msg(%MidiMessage{port: %Midiex.VirtualMidiPort{name: "MyInstrument"}, data: data}) do
  ...
end

```
- Fixes message construction bugs when using `Midiex.Message`, such as functions with the `channel:` option.
- Upgrades to Rustler v0.38.
- Removes `lazy_static` dependency in favor of Rust's built-in `std::sync::LazyLock`.
- Updates Rust dependencies to latest versions:

| Library | Old Version | New Version | Scope |
|---|---|---|---|
| `midir` | `"0.9.1"` | `"0.11.0"` | Cross-platform MIDI I/O |
| `core-foundation` | `"0.9.3"` | `"0.10.1"` | macOS Foundation wrapper (sys) |
| `coremidi` | `"0.7.0"` | `"0.9.1"` | macOS CoreMIDI API wrapper |


Additionally:
- Windows ARM based precompiled binary `aarch64-pc-windows-msvc` has been added.
- Mix test suite has been expanded, including OS/platform specific tests.
- Local cross-platform build support is available via a `Justfile`. See [BUILDING.md](BUILDING.md) for details.
- The [Live Book](midiex_notebook.html) has been updated with new examples and documentation.

## 0.6.3 (2024-09-11)
This release is just a refresh of the checksums for the precompiled binaries.

## 0.6.2 (2024-08-11)
This release includes a simple patch for high CPU load. Contributed by [@crop2000](https://github.com/crop2000).