Skip to content
Projects

iluvcapra/py-ptsl has 73 GitHub stars and 17 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 19:14 UTC. Last push 2026-10-07.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Native Python PTSL (Pro Tools Scripting Library) RPC interface

Productivity

README.md

Original

Lint and Test codecov Documentation Status GitHub last commit

Pro Tools Version - 2025.10.0 PTSL Version - 2025.10.0

py-ptsl

Native Python PTSL (Pro Tools Scripting Library) RPC interface

Important Notice!

This software is developed by enthusiasts and is not a work of or supported by Avid. Developers who wish to contribute to this project should obtain the PTSL SDK from Avid's Developer site for the most current documentation and protobuf source files.

Example

See the examples directory for scripts demonstrating how to use the client.

  • session_info.py - This example prints a list of gettable properties from the currently-open session.
  • print_tracks.py - This example prints a list of every track in the currently-open session, including state information like selection, mute and solo state, track color and track ID.
  • make_session.py - Creates a new session interactively from the terminal.
  • pt_set.py - Allows several session setup options to be set from the terminal.
  • pt_pasteboard.py - Demonstrates triggering cut/copy/paste actions.
  • toolshell.py - Implements a command line interface for Pro Tools.

Sending Commands To Pro Tools with the Engine class

The Engine class exposes ptsl commands with a method call interface.

from ptsl import open_engine

with open_engine(company_name="MY_COMPANY", application_name="MY_TOOL") as engine:
    session_name = engine.session_name()

Sending Commands to Pro Tools from the Command Line

The module implements a main function that can be called from the shell. Pass request JSON to the standard input and any response will be passed to standard output.

bash-3.2$ poetry run python3 -m ptsl GetTrackList <<JSON 
{"pagination_request": {
  "limit": 100, "offset": 0
  },
"track_filter_list": [
  {"filter": 0, "is_inverted": false}
  ]
}
JSON
{'pagination_response': {'total': 4, 'offset': 0, 'limit': 100}, 'track_list':
[{'name': 'Au dio 1', 'type': 'TT_Audio', 'format': 'TF_Mono', ...
bash-3.2$ poetry run python3 -m ptsl -n GetPTSLVersion
{"version": 2025}