Skip to content

v0.6.0 - the icon, a friendlier panel, the silent-clip fix

Choose a tag to compare

@ZeusSheen ZeusSheen released this 03 Nov 03:08
· 11 commits to main since this release

A big release: an icon and a friendlier Premiere panel, about twenty new commands, a fix for cut clips that played silent, and a security fix.

Important if you cut with 0.4.0 – 0.5.1

On Premiere 27.1, a piece made by split_clip or cut_range could look right on the timeline but render silent (audio) or empty (picture). The cause was a Premiere bug when a clip is moved past another clip; 0.6.0 no longer makes that move, and the panel refuses it. To check an older timeline, ask your helper to run review_cuts --render and export_frames over it: a silent audio piece is re-placed with the same source range, a blank picture piece is nudged a frame and back. split_clip, cut_range and extend_cut take a new --render-check that plays every piece they made.

The panel

  • The new icon sits at the top of the panel: in full colour while the bridge is running, faded when it is not.
  • A first run shows two steps: open Claude Code or Codex in a folder for the job, then paste a ready-made first message. The message already says where the bridge is installed, so the helper can do the rest.
  • A Start bridge button appears when the bridge is not running.
  • The panel speaks Chinese in a Chinese Premiere, English otherwise.

New commands

  • Sequences: set_active_sequence, list_sequences, clone_sequence (a restore point before a risky edit), save_project.
  • Markers: list_markers, remove_marker.
  • Clean-up: remove_transition, remove_effect, remove_keyframes, remove_project_items.
  • Timing: shift_items moves everything after a time on every track in one undo step.
  • Media: subclip, relink, select_items.
  • Export and effects: list_presets, export_video (renders with no time limit, --detach), list_effects, add_audio_effect, list_effect_presets, apply_preset (Premiere's .prfpset presets).
  • set_params sets keyframe interpolation ("interpolation"), and puts new effects on a title before its text layer, where they work.

Every write has a dry run, refuses before changing anything, is one labelled undo step where Premiere allows, and is read back.

Changed behaviour

  • set_volume and set_scale with --from/--to take only the clips entirely inside the range, like remove_items. --mode overlap gives the old behaviour.

Security

  • The bridge refuses to start when another program already holds its port (127.0.0.1:8017 or [::1]:8017) and names that program. Before, the panel could connect to the other program.
  • Network share paths (\\server\share) and Windows device paths are refused by the command line and by the panel, so Premiere never offers your Windows credentials to another computer. Put NAS media on a mapped drive letter.
  • Every write can carry the timeline's fingerprint (--expect-fingerprint) and is refused if the timeline changed since it was read.
  • The broker refuses more than 300 writes a minute, a guard against a runaway script.

New install

  1. Download ppro-agent-bridge-v0.6.0.zip below, right-click it and choose Extract All.
  2. Double-click 1 Install Premiere Agent Bridge.bat at the top of the extracted folder. The setup window checks your computer, fixes what is missing and puts a Premiere Agent Bridge shortcut on your desktop and in the Start menu.
  3. Double-click that shortcut (or 2 Start Premiere Agent Bridge.bat), then open the Agent Bridge panel in Premiere. The panel tells you what to send your AI helper.

Upgrading from 0.5.x

  1. Close the bridge window.
  2. Replace your bridge folder with the ppro-agent-bridge folder from the zip.
  3. Double-click 2 Start Premiere Agent Bridge.bat (or start_bridge.bat inside the folder). It reloads the panel in Premiere, so ping says "compatible": true. To get the new desktop shortcut, run 1 Install Premiere Agent Bridge.bat once.

Tests: 776 unit tests on synthetic data. The release zip passed the headless end-to-end run, which covers every command against the fake panel, the pairing token, the audit log, origin checks, a second panel refused, and ping over IPv6. B1 and the new panel commands were checked live on Premiere 27.1.