ptformat

ptformat reads and parses ProTools session files.

Audio and MIDI source/region/track information is extracted, as well as MIDI note events.

The idea is to make ardour open PT sessions.

Current functionality

Decrypt and parse a PT file:

make
./ptftool file.pt{s,5,f,x}

API

See ptftool.cc for example usage

What works?

| PT version | Decryption | Audio (Sources) | Audio (Regions) | Audio (Tracks)| MIDI (Chunks) | MIDI (Regions) | MIDI (Tracks) | | --- | --- | --- | --- | --- | --- | --- | --- | | 5 | Yes | Yes | Yes | Yes | ? | ? | ? | | 6 | Yes | Yes | Yes | Yes | ? | ? | ? | | 7 | Yes | Yes | Yes | Yes | ? | ? | ? | | 8 | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | 9 | Yes | Yes | Yes | Yes | Yes | Yes | Yes | |10 | Yes | Yes | No groups | Yes | Yes | No groups | Yes | |11 | Yes | Yes | No groups | Yes | Yes | No groups | Yes | |12 | Yes | Yes | No groups | Yes | Yes | No groups | Yes |

Regression testing

To test that nothing has broken since code has been changed:

make
./ptreg

Dummy audio file generation

To make a sox script for regenerating all audio in a PT session as dummy wavs:

make
./ptgenmissing file.pt{s,5,f,x}

Hacking

To decrypt a PT session for further inspection or adding features:

make
./ptunxor file.pt{s,5,f,x} > file.unxor

License

LGPLv2.1+

TODO

• Add >= PT10 Compound MIDI/Audio region support

Binaries in bins/

The binaries located in bins/ directory are specially crafted test sessions for regression testing this library. They are not programs!