ardour-utils version 5.11.0 Copyright (C) GPL 2015 Robin Gareus <robin@gareus.org>

ardour5-fix_bbtppq - convert an ardour session with 5.0 - 5.3 midi sources to be compatible with 5.4. Usage: ardour5-fix_bbtppq [ OPTIONS ] <session-dir> <snapshot-name> Options: -h, --help display this help and exit -f, --force override detection of affected sessions -o, --output <snapshot-name> output session snapshot name (without file suffix) -V, --version print version information and exit This Ardour-specific utility provides an upgrade path for sessions created or modified with Ardour versions 5.0 - 5.3. It creates a 5.4-compatible snapshot from affected Ardour session files. Affected versions (5.0 - 5.3 inclusive) contain a bug which caused some MIDI region properties and contents to be stored incorrectly (see more below). The utility will first determine whether or not a session requires any changes for 5.4 compatibility. If a session is determined to be affected by the bug, the program will take one of two approaches to correcting the problem. The first is to write a new MIDI source file for every existing MIDI source in the supplied snapshot. In the second approach, each MIDI region have its source converted and placed in the session midifiles directory as a new source (one source file per region). The second method is only offered if the first approach cannot logically ensure that the results would match the input snapshot. Using the first method even if the second method is offered will usually match the input exactly (partly due to a characteristic of the bug). Both methods update MIDI region properties and save a new snapshot in the supplied session-dir, optionally using a supplied snapshot name (-o). The new snapshot may be used on Ardour-5.4. Running this utility should not alter any existing files, but it is recommended that you run it on a backup of the session directory. EXAMPLE: ardour5-fix_bbtppq -o bantam ~/studio/leghorn leghorn will create a new snapshot file ~/studio/leghorn/bantam.ardour from ~/studio/leghorn/leghorn.ardour Converted midi sources will be created in ~/studio/leghorn/interchange/leghorn/midifiles/ If the output option (-o) is omitted, the string "-a54-compat" will be appended to the supplied snapshot name. About the Bug If a session from affected versions used MIDI regions and a meter note divisor was set to anything but quarter notes, the source smf files would contain events at a PPQN value derived from BBT beats (using meter note divisor) rather than quarter-note beats. The region start and length offsets would also be stored incorrectly. If a MIDI session only contains quarter note meter divisors, it will be unaffected. Report bugs to <http://tracker.ardour.org/> Website: <http://ardour.org/>