Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/orchetect/dawfilekit

A Swift library for reading and writing common import/export file formats between popular DAW applications.
https://github.com/orchetect/dawfilekit

cubase daw ios macos pro-tools protools

Last synced: about 2 months ago
JSON representation

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

Awesome Lists containing this project

README

        

# DAWFileKit

[![CI Build Status](https://github.com/orchetect/DAWFileKit/actions/workflows/build.yml/badge.svg)](https://github.com/orchetect/DAWFileKit/actions/workflows/build.yml) [![Platforms - macOS 10.15+ | iOS 10+ | tvOS 10+ | visionOS 1+](https://img.shields.io/badge/platforms-macOS%2010.15+%20|%20iOS%2010+%20|%20tvOS%2010+%20|%20visionOS%201+-lightgrey.svg?style=flat)](https://developer.apple.com/swift) ![Swift 5.5-6.0](https://img.shields.io/badge/Swift-5.5–6.0-orange.svg?style=flat) [![Xcode 13-16](https://img.shields.io/badge/Xcode-13–16-blue.svg?style=flat)](https://developer.apple.com/swift) [![License: MIT](http://img.shields.io/badge/license-MIT-lightgrey.svg?style=flat)](https://github.com/orchetect/DAWFileKit/blob/main/LICENSE)

A Swift library for reading and writing common import/export file formats between popular DAW and video editing applications with the ability to convert 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 (FCPXML) | yes | yes |
| Adobe Premiere 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 for Logic Pro X to determine what file formats are common and the viability of their implementation*.

## Dependencies

- [TimecodeKit](https://github.com/orchetect/TimecodeKit) to represent timecode values
- [MIDIKit](https://github.com/orchetect/MIDIKit) to read/write Standard MIDI Files

## 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.

### Final Cut Pro XML

- Basic support is implemented. More complete support may come in a future library update.

## 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](https://github.com/orchetect/DAWFileKit/blob/master/LICENSE) for more details.

## Author

Coded by a bunch of 🐹 hamsters in a trenchcoat that calls itself [@orchetect](https://github.com/orchetect).

## License

Licensed under the MIT license. See [LICENSE](https://github.com/orchetect/DAWFileKit/blob/master/LICENSE) for details.

## Contributions

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