premiere-cli 0.2.0__py3-none-any.whl

premiere_cli/panel/host/commands/get-clip-links.jsx

@@ -0,0 +1,135 @@
+// Command: get-clip-links → ppb_getClipLinks
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context — shared helpers (TICKS_PER_SECOND,
+// findSequenceByName, timeValueToSeconds, ...) are already defined there.
+//
+// Standard-DOM read only, no QE DOM needed. Clip addressing (sequenceName?,
+// trackType, trackIndex, clipIndex) matches get-full-clip-info.jsx. Linked
+// clips are detected heuristically — same source projectItem.nodeId and
+// the same start time — since there is no direct "get linked items" API
+// (per PREMIERE_API_NOTES.md's Clips/TrackItems section). Helper names are
+// prefixed ppbClipLinks_ to avoid colliding with same-purpose helpers in
+// other lazily-loaded command files evaluated into this same global
+// context.
+
+function ppbClipLinks_findLinked(tracks, trackTypeLabel, clipNodeId, clipStartSeconds, srcNodeId, linked) {
+  for (var t = 0; t < tracks.numTracks; t++) {
+    var track = tracks[t];
+    var numClips = 0;
+    try {
+      numClips = track.clips.numItems;
+    } catch (e) {
+      numClips = 0;
+    }
+
+    for (var c = 0; c < numClips; c++) {
+      var other = track.clips[c];
+
+      var otherNodeId = null;
+      try { otherNodeId = other.nodeId; } catch (e) { otherNodeId = null; }
+      if (otherNodeId && clipNodeId && otherNodeId === clipNodeId) {
+        continue;
+      }
+
+      var otherSrcNodeId = null;
+      try {
+        otherSrcNodeId = other.projectItem ? other.projectItem.nodeId : null;
+      } catch (e) {
+        otherSrcNodeId = null;
+      }
+
+      var otherStartSeconds = null;
+      try { otherStartSeconds = timeValueToSeconds(other.start); } catch (e) { otherStartSeconds = null; }
+
+      if (srcNodeId && otherSrcNodeId === srcNodeId && otherStartSeconds !== null && clipStartSeconds !== null && otherStartSeconds === clipStartSeconds) {
+        var entry = { nodeId: otherNodeId, name: null, trackType: trackTypeLabel, trackIndex: t, startSeconds: otherStartSeconds, endSeconds: null };
+        try { entry.name = other.name; } catch (e) { entry.name = null; }
+        try { entry.endSeconds = timeValueToSeconds(other.end); } catch (e) { entry.endSeconds = null; }
+        linked.push(entry);
+      }
+    }
+  }
+}
+
+function ppb_getClipLinks(argsJson) {
+  try {
+    var args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "invalid args JSON: " + e.toString() });
+    }
+
+    if (args.trackType !== "video" && args.trackType !== "audio") {
+      return JSON.stringify({ ok: false, error: "trackType must be \"video\" or \"audio\"" });
+    }
+    if (typeof args.trackIndex !== "number" || args.trackIndex < 0 || Math.floor(args.trackIndex) !== args.trackIndex) {
+      return JSON.stringify({ ok: false, error: "trackIndex must be a non-negative integer" });
+    }
+    if (typeof args.clipIndex !== "number" || args.clipIndex < 0 || Math.floor(args.clipIndex) !== args.clipIndex) {
+      return JSON.stringify({ ok: false, error: "clipIndex must be a non-negative integer" });
+    }
+
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var seq = null;
+    if (args.sequenceName && typeof args.sequenceName === "string") {
+      seq = findSequenceByName(args.sequenceName);
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no sequence named \"" + args.sequenceName + "\" is open" });
+      }
+    } else {
+      seq = app.project.activeSequence;
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no active sequence, and no sequenceName given" });
+      }
+    }
+
+    var trackCollection = args.trackType === "video" ? seq.videoTracks : seq.audioTracks;
+    var numTracks = trackCollection.numTracks;
+    if (args.trackIndex >= numTracks) {
+      return JSON.stringify({
+        ok: false,
+        error: "trackIndex " + args.trackIndex + " is out of range — sequence has " + numTracks + " " + args.trackType + " track(s)"
+      });
+    }
+
+    var track = trackCollection[args.trackIndex];
+    var numClips = track.clips.numItems;
+    if (args.clipIndex >= numClips) {
+      return JSON.stringify({
+        ok: false,
+        error: "clipIndex " + args.clipIndex + " is out of range — track " + args.trackIndex + " has " + numClips + " clip(s)"
+      });
+    }
+
+    var clip = track.clips[args.clipIndex];
+
+    var info = { nodeId: null, name: null, trackType: args.trackType, trackIndex: args.trackIndex, clipIndex: args.clipIndex };
+    try { info.nodeId = clip.nodeId; } catch (e) { info.nodeId = null; }
+    try { info.name = clip.name; } catch (e) { info.name = null; }
+
+    var clipStartSeconds = null;
+    try { clipStartSeconds = timeValueToSeconds(clip.start); } catch (e) { clipStartSeconds = null; }
+
+    var srcNodeId = null;
+    try {
+      srcNodeId = clip.projectItem ? clip.projectItem.nodeId : null;
+    } catch (e) {
+      srcNodeId = null;
+    }
+
+    var linked = [];
+    ppbClipLinks_findLinked(seq.videoTracks, "video", info.nodeId, clipStartSeconds, srcNodeId, linked);
+    ppbClipLinks_findLinked(seq.audioTracks, "audio", info.nodeId, clipStartSeconds, srcNodeId, linked);
+
+    info.linkedClips = linked;
+    info.linkedCount = linked.length;
+
+    return JSON.stringify({ ok: true, result: info });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}

premiere_cli/panel/host/commands/get-clip-markers.jsx

@@ -0,0 +1,144 @@
+// Command: get-clip-markers → ppb_getClipMarkers
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context — shared helpers (TICKS_PER_SECOND,
+// findSequenceByName, timeValueToSeconds, ...) are already defined there.
+//
+// Clip addressing matches get-full-clip-info.jsx (sequenceName?,
+// trackType, trackIndex, clipIndex) — the reference tool this is ported
+// from (leancoderkavy's get_clip_markers) addresses a PROJECT item by
+// item_id, but per our own convention every other clip-scoped command
+// addresses a TIMELINE clip the same way get-full-clip-info does, so this
+// reads clip.markers (a TrackItem's own marker collection — same API
+// shape as seq.markers per PREMIERE_API_NOTES.md) rather than a project
+// item's getMarkers().
+
+function ppbGetClipMarkers_serialize(clip, sourceOut) {
+  var markers = [];
+  // clip.markers (a TrackItem's own marker collection) is undefined on
+  // this Premiere 2026 build (live-tested 2026-07-17: "undefined is not
+  // an object") — fall back to the clip's source project item's
+  // getMarkers(). Semantics differ slightly (source-item markers vs
+  // timeline-clip markers); result reports which source answered.
+  var collection = null;
+  try {
+    if (clip.markers && typeof clip.markers.getFirstMarker === "function") {
+      collection = clip.markers;
+      sourceOut.source = "trackItem";
+    }
+  } catch (e) {
+    // fall through
+  }
+  if (collection === null) {
+    try {
+      var itemMarkers = clip.projectItem.getMarkers();
+      if (itemMarkers && typeof itemMarkers.getFirstMarker === "function") {
+        collection = itemMarkers;
+        sourceOut.source = "projectItem";
+      }
+    } catch (e) {
+      // fall through
+    }
+  }
+  if (collection === null) {
+    throw new Error("neither clip.markers nor clip.projectItem.getMarkers() is available on this build");
+  }
+
+  var m = collection.getFirstMarker();
+  var iterations = 0;
+  while (m !== null && typeof m !== "undefined" && iterations < 10000) {
+    var entry = { name: null, comments: null, type: null, startSeconds: null, endSeconds: null, guid: null };
+    try { entry.name = m.name; } catch (e) { entry.name = null; }
+    try { entry.comments = m.comments; } catch (e) { entry.comments = null; }
+    try { entry.type = m.type; } catch (e) { entry.type = null; }
+    try { entry.startSeconds = timeValueToSeconds(m.start); } catch (e) { entry.startSeconds = null; }
+    try { entry.endSeconds = timeValueToSeconds(m.end); } catch (e) { entry.endSeconds = null; }
+    try { entry.guid = m.guid; } catch (e) { entry.guid = null; }
+    markers.push(entry);
+
+    m = collection.getNextMarker(m);
+    iterations++;
+  }
+  return markers;
+}
+
+function ppb_getClipMarkers(argsJson) {
+  try {
+    var args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "invalid args JSON: " + e.toString() });
+    }
+
+    if (args.trackType !== "video" && args.trackType !== "audio") {
+      return JSON.stringify({ ok: false, error: "trackType must be \"video\" or \"audio\"" });
+    }
+    if (typeof args.trackIndex !== "number" || args.trackIndex < 0 || Math.floor(args.trackIndex) !== args.trackIndex) {
+      return JSON.stringify({ ok: false, error: "trackIndex must be a non-negative integer" });
+    }
+    if (typeof args.clipIndex !== "number" || args.clipIndex < 0 || Math.floor(args.clipIndex) !== args.clipIndex) {
+      return JSON.stringify({ ok: false, error: "clipIndex must be a non-negative integer" });
+    }
+
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var seq = null;
+    if (args.sequenceName && typeof args.sequenceName === "string") {
+      seq = findSequenceByName(args.sequenceName);
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no sequence named \"" + args.sequenceName + "\" is open" });
+      }
+    } else {
+      seq = app.project.activeSequence;
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no active sequence, and no sequenceName given" });
+      }
+    }
+
+    var trackCollection = args.trackType === "video" ? seq.videoTracks : seq.audioTracks;
+    var numTracks = trackCollection.numTracks;
+    if (args.trackIndex >= numTracks) {
+      return JSON.stringify({
+        ok: false,
+        error: "trackIndex " + args.trackIndex + " is out of range — sequence has " + numTracks + " " + args.trackType + " track(s)"
+      });
+    }
+
+    var track = trackCollection[args.trackIndex];
+    var numClips = track.clips.numItems;
+    if (args.clipIndex >= numClips) {
+      return JSON.stringify({
+        ok: false,
+        error: "clipIndex " + args.clipIndex + " is out of range — track " + args.trackIndex + " has " + numClips + " clip(s)"
+      });
+    }
+
+    var clip = track.clips[args.clipIndex];
+
+    var markers = [];
+    try {
+      var markerSource = { source: null };
+      markers = ppbGetClipMarkers_serialize(clip, markerSource);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "failed to read clip markers: " + e.toString() });
+    }
+
+    return JSON.stringify({
+      ok: true,
+      result: {
+        sequenceName: seq.name,
+        trackType: args.trackType,
+        trackIndex: args.trackIndex,
+        clipIndex: args.clipIndex,
+        clipName: (function () { try { return clip.name; } catch (e) { return null; } })(),
+        markers: markers,
+        markerCount: markers.length,
+        markerSource: markerSource.source
+      }
+    });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}

premiere_cli/panel/host/commands/get-clip-speed.jsx

@@ -0,0 +1,69 @@
+// Command: get-clip-speed → ppb_getClipSpeed
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context — shared helpers (findSequenceByName,
+// resolveTimelineClip, ...) are already defined there.
+//
+// READ-ONLY. Ported from leancoderkavy's premiere-pro-mcp get_clip_speed
+// tool: reads the standard-DOM clip.getSpeed()/isSpeedReversed(), the
+// same pair set-clip-speed verifies its own writes against.
+
+function ppb_getClipSpeed(argsJson) {
+  try {
+    var args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "invalid args JSON: " + e.toString() });
+    }
+
+    if (args.trackType !== "video" && args.trackType !== "audio") {
+      return JSON.stringify({ ok: false, error: "trackType must be \"video\" or \"audio\"" });
+    }
+    if (typeof args.trackIndex !== "number" || typeof args.clipIndex !== "number") {
+      return JSON.stringify({ ok: false, error: "trackIndex and clipIndex are required" });
+    }
+
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var seq = null;
+    if (args.sequenceName && typeof args.sequenceName === "string") {
+      seq = findSequenceByName(args.sequenceName);
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no sequence named \"" + args.sequenceName + "\" is open" });
+      }
+    } else {
+      seq = app.project.activeSequence;
+      if (!seq) {
+        return JSON.stringify({ ok: false, error: "no active sequence, and no sequenceName given" });
+      }
+    }
+
+    var resolved = resolveTimelineClip(seq, args.trackType, args.trackIndex, args.clipIndex);
+    if (resolved.error) {
+      return JSON.stringify({ ok: false, error: resolved.error });
+    }
+    var clip = resolved.clip;
+
+    var speed = null;
+    var isSpeedReversed = null;
+    try { speed = clip.getSpeed(); } catch (e2) { speed = null; }
+    try { isSpeedReversed = clip.isSpeedReversed() === true || clip.isSpeedReversed() === 1; } catch (e3) { isSpeedReversed = null; }
+
+    return JSON.stringify({
+      ok: true,
+      result: {
+        sequenceName: seq.name,
+        trackType: args.trackType,
+        trackIndex: args.trackIndex,
+        clipIndex: args.clipIndex,
+        clipName: (function () { try { return clip.name; } catch (e) { return null; } })(),
+        speed: speed,
+        isSpeedReversed: isSpeedReversed
+      }
+    });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}

premiere_cli/panel/host/commands/get-color-label.jsx

@@ -0,0 +1,89 @@
+// Command: get-color-label → ppb_getColorLabel
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context.
+//
+// Project-item addressing: at least one of nodeId/name is required (see
+// get-item-metadata.jsx for the shared design note — the resolver is
+// duplicated per-file since command files load independently).
+
+function ppbFindItemGetColorLabel_walk(item, args, depth) {
+  if (depth > 32) {
+    return null;
+  }
+
+  var isBin = false;
+  try {
+    isBin = typeof ProjectItemType !== "undefined" && item.type === ProjectItemType.BIN;
+  } catch (e) {
+    isBin = false;
+  }
+
+  var matched = false;
+  if (args.nodeId !== null) {
+    try { matched = item.nodeId === args.nodeId; } catch (e) { matched = false; }
+  } else if (args.name !== null) {
+    try { matched = item.name === args.name; } catch (e) { matched = false; }
+  }
+  if (matched) {
+    return item;
+  }
+
+  if (isBin && item.children) {
+    for (var i = 0; i < item.children.numItems; i++) {
+      var found = ppbFindItemGetColorLabel_walk(item.children[i], args, depth + 1);
+      if (found) {
+        return found;
+      }
+    }
+  }
+  return null;
+}
+
+function ppbFindItemGetColorLabel_resolve(args) {
+  var root = app.project.rootItem;
+  for (var i = 0; i < root.children.numItems; i++) {
+    var found = ppbFindItemGetColorLabel_walk(root.children[i], args, 1);
+    if (found) {
+      return found;
+    }
+  }
+  return null;
+}
+
+function ppb_getColorLabel(argsJson) {
+  try {
+    var args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "invalid args JSON: " + e.toString() });
+    }
+
+    var hasNodeId = typeof args.nodeId === "string" && args.nodeId.length > 0;
+    var hasName = typeof args.name === "string" && args.name.length > 0;
+    if (!hasNodeId && !hasName) {
+      return JSON.stringify({ ok: false, error: "either nodeId or name is required" });
+    }
+
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var item = ppbFindItemGetColorLabel_resolve({
+      nodeId: hasNodeId ? args.nodeId : null,
+      name: hasNodeId ? null : args.name
+    });
+    if (!item) {
+      return JSON.stringify({ ok: false, error: "no project item found matching the given nodeId/name" });
+    }
+
+    var result = { name: null, nodeId: null, colorLabel: null };
+    try { result.name = item.name; } catch (e) { result.name = null; }
+    try { result.nodeId = item.nodeId; } catch (e) { result.nodeId = null; }
+    try { result.colorLabel = item.getColorLabel(); } catch (e) { result.colorLabel = null; }
+
+    return JSON.stringify({ ok: true, result: result });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}

premiere_cli/panel/host/commands/get-color-space.jsx

@@ -0,0 +1,99 @@
+// Command: get-color-space → ppb_getColorSpace
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context.
+//
+// Project-item addressing: at least one of nodeId/name is required (see
+// get-item-metadata.jsx for the shared design note — the resolver is
+// duplicated per-file since command files load independently).
+
+function ppbFindItemGetColorSpace_walk(item, args, depth) {
+  if (depth > 32) {
+    return null;
+  }
+
+  var isBin = false;
+  try {
+    isBin = typeof ProjectItemType !== "undefined" && item.type === ProjectItemType.BIN;
+  } catch (e) {
+    isBin = false;
+  }
+
+  var matched = false;
+  if (args.nodeId !== null) {
+    try { matched = item.nodeId === args.nodeId; } catch (e) { matched = false; }
+  } else if (args.name !== null) {
+    try { matched = item.name === args.name; } catch (e) { matched = false; }
+  }
+  if (matched) {
+    return item;
+  }
+
+  if (isBin && item.children) {
+    for (var i = 0; i < item.children.numItems; i++) {
+      var found = ppbFindItemGetColorSpace_walk(item.children[i], args, depth + 1);
+      if (found) {
+        return found;
+      }
+    }
+  }
+  return null;
+}
+
+function ppbFindItemGetColorSpace_resolve(args) {
+  var root = app.project.rootItem;
+  for (var i = 0; i < root.children.numItems; i++) {
+    var found = ppbFindItemGetColorSpace_walk(root.children[i], args, 1);
+    if (found) {
+      return found;
+    }
+  }
+  return null;
+}
+
+function ppb_getColorSpace(argsJson) {
+  try {
+    var args;
+    try {
+      args = JSON.parse(argsJson);
+    } catch (e) {
+      return JSON.stringify({ ok: false, error: "invalid args JSON: " + e.toString() });
+    }
+
+    var hasNodeId = typeof args.nodeId === "string" && args.nodeId.length > 0;
+    var hasName = typeof args.name === "string" && args.name.length > 0;
+    if (!hasNodeId && !hasName) {
+      return JSON.stringify({ ok: false, error: "either nodeId or name is required" });
+    }
+
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var item = ppbFindItemGetColorSpace_resolve({
+      nodeId: hasNodeId ? args.nodeId : null,
+      name: hasNodeId ? null : args.name
+    });
+    if (!item) {
+      return JSON.stringify({ ok: false, error: "no project item found matching the given nodeId/name" });
+    }
+
+    var result = {
+      name: null,
+      nodeId: null,
+      colorSpace: null,
+      originalColorSpace: null,
+      embeddedLUT: null,
+      inputLUT: null
+    };
+    try { result.name = item.name; } catch (e) { result.name = null; }
+    try { result.nodeId = item.nodeId; } catch (e) { result.nodeId = null; }
+    try { result.colorSpace = item.getColorSpace(); } catch (e) { result.colorSpace = null; }
+    try { result.originalColorSpace = item.getOriginalColorSpace(); } catch (e) { result.originalColorSpace = null; }
+    try { result.embeddedLUT = item.getEmbeddedLUTID(); } catch (e) { result.embeddedLUT = null; }
+    try { result.inputLUT = item.getInputLUTID(); } catch (e) { result.inputLUT = null; }
+
+    return JSON.stringify({ ok: true, result: result });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}

premiere_cli/panel/host/commands/get-duplicate-media.jsx

@@ -0,0 +1,78 @@
+// Command: get-duplicate-media → ppb_getDuplicateMedia
+// Loaded lazily by ppb_dispatch (host/index.jsx) on first use, into the
+// same global ExtendScript context — shared helpers (TICKS_PER_SECOND,
+// ensureQEEnabled, findSequenceByName, ...) are already defined there.
+//
+// Recursive walk of app.project.rootItem.children (same shape as
+// list-project-items.jsx), grouping non-bin items by mediaPath and
+// reporting groups with more than one member. Helper names are prefixed
+// ppbDuplicateMedia_ to avoid colliding with same-purpose helpers in other
+// lazily-loaded command files evaluated into this same global context.
+
+function ppbDuplicateMedia_isBin(item) {
+  try {
+    return typeof ProjectItemType !== "undefined" && item.type === ProjectItemType.BIN;
+  } catch (e) {
+    return false;
+  }
+}
+
+// Capped at depth 32 to defend against pathological/circular bin
+// structures rather than looping forever.
+function ppbDuplicateMedia_scan(item, depth, pathMap, order) {
+  if (depth > 32) {
+    return;
+  }
+
+  var mediaPath = null;
+  try {
+    mediaPath = item.getMediaPath();
+  } catch (e) {
+    mediaPath = null;
+  }
+
+  if (mediaPath) {
+    if (!pathMap[mediaPath]) {
+      pathMap[mediaPath] = [];
+      order.push(mediaPath);
+    }
+    var entry = { nodeId: null, name: null, treePath: null };
+    try { entry.nodeId = item.nodeId; } catch (e) { entry.nodeId = null; }
+    try { entry.name = item.name; } catch (e) { entry.name = null; }
+    try { entry.treePath = item.treePath; } catch (e) { entry.treePath = null; }
+    pathMap[mediaPath].push(entry);
+  }
+
+  if (ppbDuplicateMedia_isBin(item) && item.children) {
+    for (var i = 0; i < item.children.numItems; i++) {
+      ppbDuplicateMedia_scan(item.children[i], depth + 1, pathMap, order);
+    }
+  }
+}
+
+function ppb_getDuplicateMedia(argsJson) {
+  try {
+    if (!app.project) {
+      return JSON.stringify({ ok: false, error: "no project open" });
+    }
+
+    var pathMap = {};
+    var order = [];
+    var root = app.project.rootItem;
+    for (var i = 0; i < root.children.numItems; i++) {
+      ppbDuplicateMedia_scan(root.children[i], 1, pathMap, order);
+    }
+
+    var duplicates = [];
+    for (var j = 0; j < order.length; j++) {
+      var path = order[j];
+      if (pathMap[path].length > 1) {
+        duplicates.push({ mediaPath: path, count: pathMap[path].length, items: pathMap[path] });
+      }
+    }
+
+    return JSON.stringify({ ok: true, result: { duplicateGroupCount: duplicates.length, duplicates: duplicates } });
+  } catch (e) {
+    return JSON.stringify({ ok: false, error: e.toString() });
+  }
+}