Use Python to interact with Adobe Premiere Pro, gather data, check, edit and automate your projects.
If you just want to create a Premiere file programmatically, you can generate and use an XML file (see Open Timeline IO to XML). But that involves manually exporting and importing files, potentially losing data and with no visual feedback.
Pymiere
was created to enable video editors and 3D/VFX studios to automate some of their workflows using Python rather than Adobe's custom scripting language ExtendScript.
- Want to check if some shots have new versions available?
- Maybe automatically place them on a new track?
- Want to create interactive tools for your editor using Qt, Shotgun API, custom libs...?
No problem!
- Support Python 2 & 3
- Tested with Adobe Premiere Pro version 15.1 (2021), version 14.5 (2020), version 13.0 (2019) and version 11.0 (2017). I highly recommend version 2019+ because some functionality isn't available in the previous versions. It should work for version 2017+ though.
- Tested on Windows 10 & macOS Catalina
-
Install Python if you haven't already.
-
Install
Pymiere
via pip:
python -m pip install pymiere
-
Install the
Pymiere Link
extension forPremiere Pro
:- Via the automatic
extension_installer
script- Download the installer script for windows or for mac
- Navigate to the download folder in Command line/Power shell (Windows) or terminal (Mac)
- Run the script by typing
extension_installer_win.bat
(Windows) or./extension_installer_mac.sh
(Mac) - Check the script output to see if it properly worked
- Alternatively via Adobe's Extension Manager
- Download Extension Manager Command Line tool (note that the User Interface is deprecated, but we just need to use the command line interface).
- Unzip the folder somewhere
- Download
pymiere_link.zxp
here - Navigate to the folder in Command line/Power shell (Windows) or terminal (Mac)
- Type (Windows)
.\ExManCmd.exe /install D:\path_to_extension\pymiere_link.zxp
- Type (Mac)
./ExManCmd --install /path_to_extension/pymiere_link.zxp
- Alternatively via ZXP installer or Anastasiy Extension Manager
- To check that the extension is correctly installed, start Premiere, under
Window > Extensions
you should seePymiere Link
(clicking on it will do nothing)
- Via the automatic
-
Try running some basic code:
import pymiere
print(pymiere.objects.app.isDocumentOpen())
Open or create a Premiere Pro project containing a Sequence with at least one video Clip. You can then run or step through demo.py which demonstrates some basic code. pymiere/wrappers.py contains more code examples.
Basically you start by creating a project
object to interact with the opened Premiere Pro application (it needs to be running), after which you can get/set its attributes and call its methods like .name
or .save()
:
project = pymiere.objects.app.project
For more snippets and examples see pymiere documentation.
- Official doc for Premiere Pro objects
- Unofficial doc for Premiere Pro objects
- Advanced Premiere Pro Extendscript usage
For any support, questions or interest please contact me: [email protected]
Pymiere
is basically a wrapper for ExtendScript (an Adobe flavour of JavaScript used for most of its Creative Cloud software). Most of the help documentation for ExtendScript therefore applies directly to Pymiere
.
In outline, this is how Pymiere
interacts with Premiere Pro:
Pymiere
converts a Python command (getting a property, executing a function etc.) to ExtendScript code.Pymiere
sends the ExtendScript code to thePymiere Link
extension via the requests library using HTTP (*)- The
Pymiere Link
extension is essentially a node.js server which receives the ExtendScript code and executes it within Premiere Pro. - Where required,
Pymiere Link
will return data as a JSON encoded response back toPymiere
. Pymiere
will then decode the JSON response for further processing in Python.
(*) NB: You must have Premiere Pro running for Pymiere
to work - it's can't run "headlessly". If your script needs to know if Premiere Pro is running, or start it, some functions are included in pymiere/exe_utils.py
for that.
So pymiere.objects
are the entry point to access all Premiere Pro objects and functions and can learn more the old school way by browsing the docstrings.
Alternatively, you'll be pleased to know Pymiere
supports code completion and type hinting so it should be easy learn more about these objects dynamically as you code using most modern IDEs.
Pymiere
includes a mirror of all Premiere Pro ExtendScript objects in Python which were autogenerated from the Extendscript objects interface. If you'd like more detail about how I did this, please read my detailed article here.
- separate the generic part handling communication between python and ExtendScript from the specific code for Premiere Pro, enabling its use in other applications (Photoshop, Encoder...)
- add support for Premiere events
- add a way to simply customize a panel to call python functions
I'd like to thank everybody that contributed to Pymiere
by reporting bugs, imrpoving the documentation, sending ideas etc. but especially:
- Isaac brown (https://github.com/ikebenbrown)
- Roy Nieterau (https://github.com/BigRoy)
- Peter Fison (https://github.com/Pfython)