Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BouncePilot

BouncePilot is a native macOS menu-bar batch-bounce queue for Pro Tools. It records solo and mute changes through Avid PTSL, then replays those changes by stable track ID for each bounce pass. It does not require SoundFlow.

Documentation: English · 简体中文 · Español · Français · Deutsch · 日本語 · 한국어 · Português do Brasil

Requirements

Component Requirement
Pro Tools 2025.12 or newer. Older versions do not provide the track-ID solo/mute workflow BouncePilot requires.
macOS macOS 12 Monterey or newer
Processor Intel x86_64 or Apple Silicon arm64
Session A Pro Tools session must be open, with memory location 99 defining the bounce range.
Permission BouncePilot needs macOS Accessibility permission for the Bounce Mix window and keyboard events. PTSL track control itself does not use Accessibility.

Confirmed live configuration: Pro Tools 2026 on macOS 14.7.1 on an Intel/Hackintosh system. The distributed build is also compiled and inspected as a Universal binary containing native x86_64 and arm64 slices, with a macOS 12.0 deployment target.

BouncePilot checks the connected PTSL version when it starts recording or batching and warns when it is older than 2025.12.

Features

  • Records solo and mute changes by Pro Tools track ID.
  • Clears all solos and mutes before recording, after recording, before a batch, and after every bounce.
  • Recalls memory location 99 as the bounce selection.
  • Runs selected passes sequentially and waits for each bounce to finish.
  • Names and confirms the Bounce Mix dialog automatically; Pro Tools retains control of the output destination and Mix Source.
  • Displays each row as Recorded, Bouncing…, or Bounced.
  • Saves each queue as a portable .bouncepilot project file that can be archived beside the .ptx session.
  • Uses one name for both the pass and its initial bounce filename; the filename can still be renamed later.
  • Provides a translucent floating window across desktop spaces and Show/Hide control from the BP menu-bar item.
  • Writes an optional PTSL diagnostic log in ~/Library/Application Support/BouncePilot/.

Using BouncePilot

  1. Launch Pro Tools, open the target session, and create memory location 99 for the bounce range.
  2. Launch BouncePilot and grant Accessibility access when requested.
  3. Click New, add a pass, and select its row.
  4. Click Record Operations. BouncePilot first clears existing solos and mutes.
  5. In Pro Tools, set the desired solo/mute state, then return to BouncePilot and click Stop Recording.
  6. Repeat for the remaining passes.
  7. Click Save As… and save the .bouncepilot file beside the .ptx session. Later edits auto-save.
  8. Select the passes, confirm the Mix Source and destination in Pro Tools, and click Batch Export Selected.

Source build

The public repository intentionally does not include Avid PTSL headers, the PTSLC_CPP.framework, or Avid's ptslcmd example binary. The Avid SDK identifies those materials as confidential and subject to the Avid SDK license. Obtain the PTSL C++ SDK directly from Avid's developer portal and accept its terms before building the helper.

Build the Swift application:

swift build -c release

From your separately downloaded Avid PTSL SDK, build its C++ client and ptslcmd example as directed by Avid:

python3 setup/build_cpp_ptsl_sdk.py --target ptsl.client.cpp --config Release
python3 setup/build_cpp_ptsl_sdk.py --target ptslcmd.sdk --config Release

Place the resulting executable and framework here for development:

Tools/ptslcmd
Tools/PTSLC_CPP.framework/

ptslcmd must be able to resolve PTSLC_CPP.framework through @executable_path. For a distributable Universal app, build both arm64 and x86_64 SDK outputs, combine corresponding binaries with lipo, place them beside the BouncePilot executable in the app bundle, and sign the nested framework/helper before signing the app.

Project-file format

.bouncepilot files are JSON documents containing pass names, bounce filenames, recorded track operations, and completion state. They contain no audio and no Pro Tools session media.

Legal and attribution

BouncePilot is an independent project and is not affiliated with or endorsed by Avid Technology, Andrew Scheps, Bounce Factory, or SoundFlow. Pro Tools is a trademark of Avid Technology. This repository contains no Bounce Factory or SoundFlow source code, assets, or branding.

Developed by BJFUofficial in collaboration with OpenAI Codex.

About

Native macOS Pro Tools batch-bounce queue using PTSL — no SoundFlow required

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages