prem-down

README

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.

Premiere Pro Productions are supported too. A Production is a folder rather than a single file, so prem-down copies the whole thing to a sibling <name>_downgraded folder – downgrading the settings file and every project inside.

🚀 Installation

macOS

1. Download the 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

1. Download the installer and open it (if Windows warns about an unknown publisher, choose "Remove protection and open").

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

📖 Usage

Context Menu Integration

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

Downgrade a whole Production:

prem-down MyProduction/MyProduction.prodset

Manage context menu right-click action:

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

Manage automatic update checks:

prem-down updates on          # activate check for updates
prem-down updates off         # deactivate check for updates

🧪 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.