Skip to content

Repository files navigation

OS CI codecov

prem-down downgrades an Adobe Premiere Pro project file so an older version of Premiere can open it. It runs completely offline and local to your machine – no data is ever uploaded to the internet.

It fully supports the breaking changes introduced with Premiere Pro 2026. The well-known method (gunzip the .prproj, lower the top-level project version, re-gzip) no longer works reliably on Premiere 2026 files. The cause is that 2026 uses sparser serialisation — it drops fields that older releases expect present (and report the project as damaged if they are absent). So the fix is bifold: re-insert those required fields, and set the project version to the target release.

🚀 Installation

macOS

  1. Download the macOS installer and open it. If macOS refuses to open it go to "System Settings > Privacy & Security", scroll to the message about the prem-down installer and click "Open Anyway".

  2. Alternatively, install with Homebrew: brew install lucuma13/dit/prem-down

  3. Check that the action is now available when right-clicking a Premiere Pro project file (.prproj), under "Quick Actions > Downgrade for older Premiere". If it isn't, switch it on manually with "Quick Actions > Customise…"

Windows

Download the Windows installer and open it (if Windows warns about an unknown publisher, choose "More info" > "Run anyway").

Alternatively, install from Terminal: winget install -e --id lucuma13.prem-down

📖 Usage

The tool is available on the context menu (right-click on any Premiere Pro project file) or via Terminal. It creates a downgraded copy of the project file, leaving the original untouched.

Context Menu Integration

Downgrade any project to the previous release:

  • macOS Finder: right-click any Premiere Pro project file(s) and choose "Quick Actions > Downgrade for older Premiere"
  • Windows File Explorer: right-click any Premiere Pro project file(s) and choose "Show more options > Downgrade for older Premiere"

CLI (Terminal)

Downgrade any project to the previous release:

prem-down myproject.prproj

Downgrade any project to specific Premiere Pro version:

prem-down myproject.prproj --to 2024

If the action is ever missing (or you want to remove it before uninstalling), manage it from the Terminal:

prem-down integrate           # add the right-click action
prem-down integrate --remove  # remove it

To uninstall, run this command on Terminal:

prem-down integrate --remove && rm -f /usr/local/bin/prem-down

🧪 Feedback & Contributing

While backwards-compatibility between Premiere Pro 2026 and 2025 has been throrougly tested, you must verify your downgraded project manually. Features, effects or tools native to newer Premiere releases will not render or translate when opened in an older version.

If a downgraded project fails to load or exhibits unexpected behavior, please submit a detailed issue on the GitHub repository with the source and target version numbers.

Releases

Contributors

Languages