Swiftpack.co - orchetect/DAWFileKit as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by orchetect.
orchetect/DAWFileKit 0.2.1
A Swift library for reading and writing common import/export file formats between popular DAW applications.
⭐️ 6
🕓 5 weeks ago
iOS macOS watchOS tvOS
.package(url: "https://github.com/orchetect/DAWFileKit.git", from: "0.2.1")

DAWFileKit

CI Build Status Platforms - macOS 10.12+ | iOS 10+ | tvOS 10+ Swift 5.5-5.7 Xcode 13-14 License: MIT

A Swift library for reading and writing common import/export file formats between popular DAW applications and converting between formats.

Supported File Formats

Format Read Write
Cubase: Track Archive XML yes† yes†
Pro Tools: Session Info text file yes n/a
Standard MIDI File planned yes
Logic Pro X‡ future? future?
Final Cut Pro XML future? future?

† Full read/write support for Cubase Track Archive XML files is implemented for tracks with absolute timebase, as well as tracks with musical timebase where the tempo track uses only 'Jump' tempo events and there are no 'Ramp' tempo events

‡ Research is needed to determine what file formats are common and the viability of their implementation

Dependencies

Documentation

No formal documentation yet.

Unit Tests

Core unit tests implemented. More exhaustive tests can be added in future.

Known Issues

Cubase: Track Archive XML

  • Ascertaining the absolute time position of events on tracks that are in musical timebase when the tempo track contains 'Ramp' tempo event(s) is currently not possible. The internal curve function that Cubase uses to calculate tempo ramps is not intuitive (ie: not linear or any obvious known curve function), and it may be a proprietary function. So this may never be possible with this library. The workaround is to not use 'Ramp' tempo events in a session, or if that is unavoidable, move/copy events to a track that is using absolute timebase which can be interpreted reliably with this library.

Affiliation

The author(s) have no affiliation with Apple, Avid, Steinberg, or any other company relating to the software packages that are mentioned in this library. This library is built based on open file data format such as text, XML and MIDI. No reverse-engineering of software was involved in implementation of this library. The goal is to promote easier interoperability for developers with these common and useful data file formats.

The library is provided as-is with no warranties. See the LICENSE for more details.

Author

Coded by a bunch of 🐹 hamsters in a trenchcoat that calls itself @orchetect.

License

Licensed under the MIT license. See LICENSE for details.

Contributions

Contributions are welcome. Feel free to post an Issue to discuss.

GitHub

link
Stars: 6
Last commit: 2 weeks ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Dependencies

Release Notes

0.2.1
5 weeks ago

New DAWMarker Type

  • New DAW-agnostic marker type that can be used as an intermediary when converting between marker types of various file formats
  • Additional DAW-agnostic types may be added for other event types in future (Audio clips, etc.)

Cubase.TrackArchive Improvements

  • Added init(converting: [DAWMarker]) to produce a TrackArchive from generic markers
  • Added extractDAWMarkers() method

ProTools.SessionInfo Improvements

  • Added support for parsing all time formats - timecode, min|secs, bars|beats, samples, feet+frames
  • Added main time format auto-detection heuristic when time format is not explicitly supplied
  • Improved parser robustness
  • Added extractDAWMarkers() method
  • Additional unit tests

MIDIFile Support Added

  • Added init(converting: [DAWMarker]) to produce a MIDIFile from generic markers at any static tempo
  • WIP: extractDAWMarkers() method will be finished in a future release
See all

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics