0.8.7

• MIDINote: Removed init(style:)
• MIDIEvent.NoteOn: midi1ZeroVelocityAsNoteOff now defaults to false (#176)

0.8.6

New

• New MIDIKItUI module with reusable SwiftUI views for endpoint lists and pickers (WIP) - see new MIDIKitUIExample project
• MIDIIOObject: Added image property to return SwiftUI Image

Improvements

• MIDIEndpointIdentity: locate(in:) is now public, added new matches(endpoint:) sister method
• Collection of MIDIEndpoint: added filter(using: MIDIEndpointFilter) method

Fixes

• MIDIFile: Fixed extended characters in text events failing to parse (#171)

0.8.5

• MIDIInput/MIDIOutput: Renamed endpointName to name, and is now settable (#168)
• MIDIFileEvent: Added delta convenience property
• Added new MusicalTimeValue value type for converting between SMF delta times and bars & beats

0.8.4

New

• MIDIKit now requires Xcode 14 to build. It still supports macOS 10.12+ and iOS 10+ once compiled.
• MIDIDevice: Added inputs and outputs convenience properties to return endpoint arrays (#129)
• MIDIDevices: Added inputs and outputs convenience properties to return endpoint dictionaries (#129)

Improvements

• MIDIInput/MIDIInputConnection: Resolved potential race condition in receiver
• Memory access for legacy MIDIPacket / MIDIPacketList is more stable
• MIDIPacketList: Fixed bug when sending legacy packet list containing multiple packets
• Minor documentation & unit test updates

0.8.3

• Updated for TimecodeKit 1.6.9

0.8.2

Fixes

• MIDI thru connections are now available on all supported platforms (#164)

  Background

  • A Core MIDI bug where all MIDI thru connections were non-functional affected all Apple platforms for two generations:
    • macOS 11.x through 12.x and iOS 14.x through 15.x were affected
    • The issue was resolved in macOS 13.0 and iOS 16.0

  Resolution

  • For non-persistent thru connections on affected platforms, MIDIKit now transparently implements an internal event pipe that replicates the functionality of Core MIDI. This means midiManager.addThruConnection() can be called and will always function as expected, regardless of platform.
  • For persistent thru connections on affected platforms, no internal/automatic workaround is possible, and calling midiManager.addThruConnection() will result in an error being thrown. For this reason it is recommended to not utilize or rely on these persistent connections, and to defer to non-persistent ones instead.

0.8.1

New

• SysEx7 inits that take UInt8 data bytes now throw; Added non-throwing UInt7 overloads.
• AnyMIDIIOObject.Property: Added name property
• MIDIIOObject: Added propertyStringValue(for:)

Fixes

• MIDIIONotification: Fixed missing metadata for sequential remove notifications (#162)

Changes

• MIDIIONotification: Renamed parameters for added, removed, and propertyChanged
• MIDIIOObject: Renamed propertiesAsStrings() to propertyStringValues()

Examples

• Example projects have been consolidated and reorganized. SwiftUI examples are now multiplatform projects that can build for iOS or macOS destinations.
• Added new SystemNotifications SwiftUI example project
• MIDISystemInfo example project has been improved

Docs

• Added MIDI Show Control guide

0.8.0

New

• RPN/NRPN messages are now fully implemented for I/O and MIDI file read/write (#158)

Improvements

• MIDIEvent: description now outputs both MIDI 1.0 and MIDI 2.0 values for events to avoid confusion for those unfamiliar with MIDI 2.0 (also used when logging using the eventsLogging() receiver)
• UInt7Pair: Added pretty output description
• Updated example projects to reflect new rpn and nrpn cases for MIDIEvent
• Docs updated
• Unit tests updated

Fixes

• RPN/NRPN UMP packets may have failed to parse before
• Setting MIDIManager.preferredAPI = .legacyCoreMIDI now works correctly on macOS 13+ and iOS 16+

0.7.3

• Added hide() and show() to virtual endpoints to control visibility to the user in the system endpoints
• MIDIReceiver.create() now has public access level (for power-users)
• Moved various Core MIDI utilities to MIDIKitInternals with public access level (for power-users)
• Minor formatting and housekeeping

0.7.2

Internal updates for TimecodeKit 1.6.0 API changes.

No functional changes from MIDIKit 0.7.1.