conformtools 0.6.0 → 0.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/README.md +27 -17
  2. package/dist/browser/timeline_core_bg.wasm +0 -0
  3. package/dist/{chunk-PZFWQJCF.js → chunk-5K56Q5EX.js} +1 -1
  4. package/dist/chunk-6FVGUJ6L.js +3 -0
  5. package/dist/{chunk-N43NAG5E.js → chunk-BK62N3ID.js} +1 -1
  6. package/dist/{chunk-AHNDJFQR.js → chunk-BUEIRRNY.js} +1 -1
  7. package/dist/{chunk-XDHIIZ6A.js → chunk-CETBLAWM.js} +1 -1
  8. package/dist/{chunk-ZAHP3ES5.js → chunk-D2RXAX5C.js} +1 -1
  9. package/dist/chunk-D5DEQ467.js +3 -0
  10. package/dist/chunk-EV52G33S.js +354 -0
  11. package/dist/chunk-FMYTLXWN.js +3 -0
  12. package/dist/{chunk-R6WJ6JIQ.js → chunk-JBSH4AK3.js} +1 -1
  13. package/dist/{chunk-PSMXHDMX.js → chunk-LO4K2ZF3.js} +1 -1
  14. package/dist/{chunk-UUDNNFU7.js → chunk-R7P7WVNI.js} +1 -1
  15. package/dist/{chunk-7XTBFOUJ.js → chunk-WE4S4PEA.js} +1 -1
  16. package/dist/claude-setup-XSNTKEU7.js +5 -0
  17. package/dist/cli.js +10 -5
  18. package/dist/conformtools-decode +0 -0
  19. package/dist/{cr3-wasm-CWKEOCYH.js → cr3-wasm-HTRSUBJK.js} +1 -1
  20. package/dist/{dng-wasm-JNFS44V5.js → dng-wasm-2I7S2SN4.js} +1 -1
  21. package/dist/{dpx-wasm-VNJRFPYY.js → dpx-wasm-AHH7D56L.js} +1 -1
  22. package/dist/{exr-wasm-5D66YR7A.js → exr-wasm-3TAN64WQ.js} +1 -1
  23. package/dist/{h264-ZB5DJSNV.js → h264-2LU2X635.js} +1 -1
  24. package/dist/{h264-mxf-NVBLGU3V.js → h264-mxf-5HJUSZLL.js} +1 -1
  25. package/dist/http.js +1 -1
  26. package/dist/i2o-transfer +0 -0
  27. package/dist/{inspect-MGSZRRAF.js → inspect-NY36WVMH.js} +1 -1
  28. package/dist/isobmff-HSF7B3Y7.js +3 -0
  29. package/dist/mcp.js +8 -9
  30. package/dist/{media_core-AISE7FMT.js → media_core-R5PPN3AY.js} +2 -2
  31. package/dist/{media_core_bg-FGAR5KA5.js → media_core_bg-MEORQOCQ.js} +1 -1
  32. package/dist/mxf-IQBPP3JA.js +3 -0
  33. package/dist/{ops-BQDPU4M6.js → ops-PFEKOSET.js} +1 -1
  34. package/dist/{r3d-T6D3M2XJ.js → r3d-QLV4J6YF.js} +1 -1
  35. package/dist/{r3d-U4XTQJXQ.js → r3d-YZH6X2D7.js} +1 -1
  36. package/dist/resolve-bridge.py +465 -37
  37. package/dist/statusline-GMMCFMOA.js +4 -0
  38. package/dist/statusline.js +3 -0
  39. package/dist/still-LORP3E5C.js +3 -0
  40. package/dist/{tiff-wasm-2CEABW6L.js → tiff-wasm-6XFTTCL4.js} +1 -1
  41. package/dist/wasm/media_core_bg.wasm +0 -0
  42. package/dist/wasm/udf_bg.wasm +0 -0
  43. package/dist/wasm-threads/media_core_bg.wasm +0 -0
  44. package/dist/{wav-KNJZMOGX.js → wav-PMVKVYNP.js} +1 -1
  45. package/package.json +1 -1
  46. package/dist/chunk-E6YXZIJS.js +0 -230
  47. package/dist/chunk-JEMLKBH2.js +0 -3
  48. package/dist/chunk-RXHNBSER.js +0 -3
  49. package/dist/isobmff-7G55HKDG.js +0 -3
  50. package/dist/mxf-YH2A2XLW.js +0 -3
  51. package/dist/skills/auto-conform/SKILL.md +0 -87
  52. package/dist/skills/conform-artist/SKILL.md +0 -68
  53. package/dist/skills/conform-artist/references/avid.md +0 -19
  54. package/dist/skills/conform-artist/references/other-hosts.md +0 -23
  55. package/dist/skills/conform-artist/references/premiere.md +0 -18
  56. package/dist/skills/conform-artist/references/resolve.md +0 -19
  57. package/dist/skills/conform-artist/references/troubleshooting.md +0 -33
  58. package/dist/skills/conform-artist/references/turnover-checklist.md +0 -37
  59. package/dist/skills/delivery-qc/SKILL.md +0 -48
  60. package/dist/still-UFLOAEM4.js +0 -3
  61. /package/dist/{arriraw-3GKCR6K2.js → arriraw-GUQEZ7CH.js} +0 -0
  62. /package/dist/{chunk-WHY3DVXS.js → chunk-GIZIR52D.js} +0 -0
  63. /package/dist/{media_core_bg-YK63OUDM.js → media_core_bg-5QHIWEZB.js} +0 -0
  64. /package/dist/{prores-L4JZZWGH.js → prores-BR2YURFP.js} +0 -0
  65. /package/dist/{timeline_core_bg-2TYWZ35G.js → timeline_core_bg-DFKQ7XOU.js} +0 -0
  66. /package/dist/{udf_bg-A4WEMSAX.js → udf_bg-ZIB3GK52.js} +0 -0
@@ -17,8 +17,13 @@ Python 3.6+ (what Resolve supports); standard library only.
17
17
  """
18
18
  import json
19
19
  import os
20
+ import re
21
+ import shutil
22
+ import struct
20
23
  import sys
24
+ import tempfile
21
25
  import time
26
+ import uuid
22
27
 
23
28
  OK = 0
24
29
  FAIL = 1
@@ -106,25 +111,129 @@ def a_current(resolve, _args):
106
111
  "project": p.GetName(),
107
112
  "timelines": [x.GetName() for x in timelines(p)],
108
113
  "timeline": t.GetName() if t else None,
114
+ "tracks": tracks_of(t) if t else [],
109
115
  "page": resolve.GetCurrentPage(),
110
116
  "db": pm.GetCurrentDatabase() or {},
111
117
  }
112
118
 
113
119
 
120
+ def tracks_of(t):
121
+ """Every track of a timeline: kind, 1-based index, name, enabled, locked."""
122
+ out = []
123
+ for kind in ("video", "audio", "subtitle"):
124
+ for i in range(1, int(t.GetTrackCount(kind) or 0) + 1):
125
+ out.append({"kind": kind, "index": i, "name": t.GetTrackName(kind, i),
126
+ "enabled": bool(t.GetIsTrackEnabled(kind, i)), "locked": bool(t.GetIsTrackLocked(kind, i))})
127
+ return out
128
+
129
+
130
+ def pool_folder(media_pool, path, create=False):
131
+ """The media pool folder at "A/B/C" under the root ("" = the root). Missing folders are created
132
+ only when `create`; otherwise (None, the first missing name)."""
133
+ f = media_pool.GetRootFolder()
134
+ for seg in [x for x in (path or "").split("/") if x]:
135
+ nxt = next((x for x in f.GetSubFolderList() or [] if x.GetName() == seg), None)
136
+ if not nxt and create:
137
+ nxt = media_pool.AddSubFolder(f, seg)
138
+ if not nxt:
139
+ return None, seg
140
+ f = nxt
141
+ return f, None
142
+
143
+
144
+ def a_project(resolve, args):
145
+ """Read-only project awareness: the media pool tree (folders, clip counts, optionally every clip
146
+ with its file), which pool clips match `find` (a path, or a name fragment), the render queue
147
+ with every job's settings as Resolve reports them, and the tracks of a timeline."""
148
+ _pm, p = project_or_fail(resolve)
149
+ mp = p.GetMediaPool()
150
+ want_clips = bool(args.get("clips"))
151
+ finds = [str(q) for q in args.get("find") or []]
152
+ found = dict((q, []) for q in finds)
153
+
154
+ # ponytail: GetClipProperty per clip walks the whole pool; fine for thousands, page it if it ever is not
155
+ def walk(folder, path):
156
+ clips = folder.GetClipList() or []
157
+ node = {"path": path, "clips": len(clips), "folders": []}
158
+ if want_clips or finds:
159
+ rows = []
160
+ for c in clips:
161
+ pr = c.GetClipProperty() or {}
162
+ row = {"name": c.GetName(), "file": pr.get("File Path") or "", "start_tc": pr.get("Start TC") or "",
163
+ "usage": pr.get("Usage") or "", "folder": path}
164
+ rows.append(row)
165
+ for q in finds:
166
+ if ("/" in q and row["file"] and os.path.normpath(row["file"]) == os.path.normpath(q)) or (
167
+ "/" not in q and (q.lower() in row["name"].lower()
168
+ or q.lower() in os.path.basename(row["file"]).lower())):
169
+ found[q].append(row)
170
+ if want_clips:
171
+ node["clip_list"] = rows
172
+ for sub in folder.GetSubFolderList() or []:
173
+ node["folders"].append(walk(sub, (path + "/" if path else "") + sub.GetName()))
174
+ return node
175
+
176
+ jobs = []
177
+ for j in p.GetRenderJobList() or []:
178
+ j = dict(j)
179
+ st = p.GetRenderJobStatus(j.get("JobId")) or {}
180
+ j["JobStatus"] = st.get("JobStatus", "")
181
+ j["CompletionPercentage"] = st.get("CompletionPercentage")
182
+ jobs.append(j)
183
+ t = find_timeline(p, args.get("timeline")) if (args.get("timeline") or p.GetCurrentTimeline()) else None
184
+ return {"ok": True, "project": p.GetName(), "pool": walk(mp.GetRootFolder(), ""), "found": found,
185
+ "jobs": jobs, "timeline": t.GetName() if t else None, "tracks": tracks_of(t) if t else [],
186
+ "timelines": [x.GetName() for x in timelines(p)], "page": resolve.GetCurrentPage()}
187
+
188
+
114
189
  def a_export(resolve, args):
115
- """A timeline → Resolve's own .drt (read-only on the project). Export does not switch timelines."""
190
+ """A timeline → Resolve's own .drt (read-only on the project). The user's current timeline
191
+ is left (or put back) as it was.
192
+
193
+ Resolve's Export is fussy about the target path (spaces / non-ASCII / a folder instead of a
194
+ file all come back as a bare False), so it always writes to a plain ASCII temp file that we
195
+ then move to out_path. Some builds also refuse a timeline that is not the current one: on a
196
+ False we retry once with it made current, then restore the user's timeline."""
116
197
  _pm, p = project_or_fail(resolve)
117
198
  t = find_timeline(p, args.get("timeline"))
118
199
  out = args["out_path"]
119
- if os.path.exists(out):
120
- os.remove(out)
121
- ok = bool(t.Export(out, resolve.EXPORT_DRT))
122
- # Export returns True for some failures and writes a bundle for others: trust the file.
123
- if not os.path.isfile(out) or os.path.getsize(out) == 0:
124
- fail("export_failed", "Resolve did not write %s (Export returned %s)" % (out, ok))
200
+ if os.path.isdir(out) or not os.path.splitext(out)[1]:
201
+ out = os.path.join(out, safe_name(t.GetName()) + ".drt")
202
+ parent = os.path.dirname(os.path.abspath(out))
203
+ if not os.path.isdir(parent):
204
+ os.makedirs(parent)
205
+ tmp_dir = tempfile.mkdtemp(prefix="conform_export_")
206
+ tmp = os.path.join(tmp_dir, "timeline.drt")
207
+
208
+ def wrote():
209
+ return os.path.isfile(tmp) and os.path.getsize(tmp) > 0
210
+
211
+ try:
212
+ ok = bool(t.Export(tmp, resolve.EXPORT_DRT))
213
+ prev = p.GetCurrentTimeline()
214
+ if not wrote() and (not prev or prev.GetName() != t.GetName()):
215
+ p.SetCurrentTimeline(t)
216
+ try:
217
+ ok = bool(t.Export(tmp, resolve.EXPORT_DRT))
218
+ finally:
219
+ if prev:
220
+ p.SetCurrentTimeline(prev)
221
+ # Export returns True for some failures and writes a bundle for others: trust the file.
222
+ if not wrote():
223
+ fail("export_failed", "Resolve did not write the .drt for %r (Export returned %s)" % (t.GetName(), ok))
224
+ if os.path.exists(out):
225
+ os.remove(out)
226
+ shutil.move(tmp, out)
227
+ finally:
228
+ shutil.rmtree(tmp_dir, ignore_errors=True)
125
229
  return {"ok": True, "path": out, "format": "drt", "project": p.GetName(), "timeline": t.GetName()}
126
230
 
127
231
 
232
+ def safe_name(name):
233
+ """A timeline name as a file name: anything but [A-Za-z0-9._-] becomes _."""
234
+ return re.sub(r"[^A-Za-z0-9._-]+", "_", name).strip("_") or "timeline"
235
+
236
+
128
237
  OUR_FOLDER = "conform.tools"
129
238
 
130
239
 
@@ -149,9 +258,11 @@ def our_folder(media_pool):
149
258
 
150
259
  def a_open(resolve, args):
151
260
  """A timeline file -> a NEW timeline in the open project (never overwrites), inside the
152
- conform.tools media pool folder. The user's timeline, folder and page are restored unless
153
- `stay`. `into: scratch` switches to (or creates) our scratch project instead, saving the
154
- user's project first so nothing of theirs is lost, and switches back afterwards."""
261
+ conform.tools media pool folder, or `folder` ("000 - TIMELINES/20261006"; missing folders are
262
+ created only with `create_folder`). `link_existing` imports with importSourceClips False: the
263
+ timeline links to clips already in the pool, no duplicates. The user's timeline, folder and page
264
+ are restored unless `stay`. `into: scratch` switches to (or creates) our scratch project instead,
265
+ saving the user's project first so nothing of theirs is lost, and switches back afterwards."""
155
266
  pm, p = project_or_fail(resolve)
156
267
  path = args["path"]
157
268
  if not os.path.isfile(path):
@@ -169,38 +280,62 @@ def a_open(resolve, args):
169
280
  prev_tl = p.GetCurrentTimeline()
170
281
  mp = p.GetMediaPool()
171
282
  prev_folder = mp.GetCurrentFolder()
172
- folder = our_folder(mp)
283
+
284
+ def restore():
285
+ if prev_folder:
286
+ mp.SetCurrentFolder(prev_folder)
287
+ if prev_tl:
288
+ p.SetCurrentTimeline(prev_tl)
289
+ if args.get("into") == "scratch" and prev_project != p.GetName():
290
+ pm.SaveProject()
291
+ pm.LoadProject(prev_project)
292
+ if resolve.GetCurrentPage() != page:
293
+ resolve.OpenPage(page)
294
+ return True
295
+
296
+ if args.get("folder"):
297
+ folder, missing = pool_folder(mp, args["folder"], bool(args.get("create_folder")))
298
+ if not folder:
299
+ restore()
300
+ fail("no_folder", "no media pool folder %r in %r (pass create_folder to create it)" % (missing, args["folder"]))
301
+ folder_name = args["folder"]
302
+ else:
303
+ folder, folder_name = our_folder(mp), OUR_FOLDER
173
304
  if folder:
174
305
  mp.SetCurrentFolder(folder)
175
306
  name = unique_name(p, args.get("name") or os.path.splitext(os.path.basename(path))[0])
176
- opts = {"timelineName": name, "importSourceClips": True}
177
- if args.get("media_dir"):
307
+ link = bool(args.get("link_existing"))
308
+ opts = {"timelineName": name, "importSourceClips": not link}
309
+ if args.get("media_dir") and not link:
178
310
  opts["sourceClipsPath"] = args["media_dir"]
179
311
  tl = mp.ImportTimelineFromFile(path, opts)
180
- if not tl:
312
+ if not tl and not link:
181
313
  tl = mp.ImportTimelineFromFile(path, {"timelineName": name, "importSourceClips": False})
182
314
  notes = []
183
315
  if tl and tl.GetName() != name: # Resolve may name it after the file
184
316
  tl.SetName(name)
185
317
  got = tl.GetName() if tl else None
186
- restored = False
187
- if not args.get("stay"):
188
- if prev_folder:
189
- mp.SetCurrentFolder(prev_folder)
190
- if prev_tl:
191
- p.SetCurrentTimeline(prev_tl)
192
- if args.get("into") == "scratch" and prev_project != p.GetName():
193
- pm.SaveProject()
194
- pm.LoadProject(prev_project)
195
- if resolve.GetCurrentPage() != page:
196
- resolve.OpenPage(page)
197
- restored = True
318
+ restored = restore() if (not args.get("stay") or not tl) else False
198
319
  if not tl:
199
320
  fail("import_failed", "Resolve refused to import %s" % path, restored=restored)
200
321
  if not opts.get("sourceClipsPath") and args.get("media_dir"):
201
- notes.append("media_dir was not used")
202
- return {"ok": True, "project": p.GetName(), "timeline": got, "folder": OUR_FOLDER if folder else None,
203
- "restored": restored, "notes": notes}
322
+ notes.append("media_dir was not used" + (" (link_existing links to clips already in the pool)" if link else ""))
323
+ return {"ok": True, "project": p.GetName(), "timeline": got, "folder": folder_name if folder else None,
324
+ "linked_existing": link, "restored": restored, "notes": notes}
325
+
326
+
327
+ def tc_frames(tc, fps):
328
+ """"HH:MM:SS:FF" (";FF" drop-frame at 29.97/59.94) -> absolute frames; None when not a timecode."""
329
+ m = re.match(r"^(\d+)[:;.](\d+)[:;.](\d+)([:;.])(\d+)$", str(tc).strip())
330
+ if not m:
331
+ return None
332
+ h, mi, se, ff = int(m.group(1)), int(m.group(2)), int(m.group(3)), int(m.group(5))
333
+ r = int(round(float(fps)))
334
+ n = (h * 3600 + mi * 60 + se) * r + ff
335
+ if m.group(4) == ";" and r in (30, 60):
336
+ total = h * 60 + mi
337
+ n -= (2 if r == 30 else 4) * (total - total // 10)
338
+ return n
204
339
 
205
340
 
206
341
  # ── render ────────────────────────────────────────────────────────────────
@@ -220,6 +355,37 @@ def find_job(project, job_id):
220
355
  return None
221
356
 
222
357
 
358
+ def track_matches(t, ref):
359
+ """1-based video track indices named `ref` (case-insensitive, every track so named) or "V7"."""
360
+ r = str(ref).strip().lower()
361
+ return [i for i in range(1, int(t.GetTrackCount("video") or 0) + 1)
362
+ if (t.GetTrackName("video", i) or "").strip().lower() == r or "v%d" % i == r]
363
+
364
+
365
+ def video_tracks_named(t, refs):
366
+ """track_matches for every ref; any ref without a track refuses before anything is touched."""
367
+ out = []
368
+ for ref in refs:
369
+ hit = track_matches(t, ref)
370
+ if not hit:
371
+ fail("no_track", "no video track named %r on %r" % (ref, t.GetName()),
372
+ tracks=[{"index": i, "name": t.GetTrackName("video", i)}
373
+ for i in range(1, int(t.GetTrackCount("video") or 0) + 1)])
374
+ out += [i for i in hit if i not in out]
375
+ return sorted(out)
376
+
377
+
378
+ def set_video_tracks(resolve, t, indices, enabled):
379
+ """SetTrackEnable takes effect only on the Edit page (elsewhere it returns True and does
380
+ nothing; Resolve 21.1): switch to Edit, set, read every track back. Returns those that did not
381
+ take."""
382
+ if indices and resolve.GetCurrentPage() != "edit":
383
+ resolve.OpenPage("edit")
384
+ for i in indices:
385
+ t.SetTrackEnable("video", i, enabled)
386
+ return [i for i in indices if bool(t.GetIsTrackEnabled("video", i)) != enabled]
387
+
388
+
223
389
  def a_render_start(resolve, args):
224
390
  _pm, p = project_or_fail(resolve)
225
391
  if p.IsRenderingInProgress():
@@ -228,14 +394,37 @@ def a_render_start(resolve, args):
228
394
  if not os.path.isdir(target):
229
395
  os.makedirs(target)
230
396
  page = resolve.GetCurrentPage()
231
- if args.get("renderplugin") is not None or args.get("preset"):
397
+ if args.get("renderplugin") is not None or args.get("preset") or args.get("audio_tracks"):
232
398
  _deliver_ready(resolve, p)
233
399
  prev_tl = p.GetCurrentTimeline()
234
400
  tl = find_timeline(p, args.get("timeline"))
235
401
  if not prev_tl or prev_tl.GetName() != tl.GetName():
236
402
  p.SetCurrentTimeline(tl)
403
+ # The documented RenderSettings have no per-job track selection ("Render All Video Tracks"):
404
+ # the named tracks are switched off for our job and back on when it ends (render_finish).
405
+ off = []
406
+ if args.get("disable_tracks"):
407
+ off = [i for i in video_tracks_named(tl, args["disable_tracks"]) if tl.GetIsTrackEnabled("video", i)]
408
+ bad = set_video_tracks(resolve, tl, off, False)
409
+ if bad:
410
+ set_video_tracks(resolve, tl, off, True)
411
+ resolve.OpenPage(page)
412
+ fail("tracks_not_disabled", "Resolve did not switch off video track(s) %s; nothing was queued" % bad)
413
+ if args.get("renderplugin") is not None or args.get("preset"):
414
+ resolve.OpenPage("deliver")
415
+ try:
416
+ return _queue_and_start(resolve, p, tl, args, target, page, prev_tl, off)
417
+ except BaseException:
418
+ if off:
419
+ set_video_tracks(resolve, tl, off, True)
420
+ resolve.OpenPage(page)
421
+ raise
422
+
423
+
424
+ def _queue_and_start(resolve, p, tl, args, target, page, prev_tl, off):
237
425
  keep = "%s%d_%d" % (KEEP_PREFIX, os.getpid(), int(time.time() * 1000))
238
426
  kept = bool(p.SaveAsNewRenderPreset(keep))
427
+ routed, rejected = None, []
239
428
  if args.get("renderplugin") is not None:
240
429
  args["preset"] = QC_PRESET
241
430
  for f in QC_REPORTS: # a stale report from an earlier run is the classic wrong answer
@@ -247,18 +436,24 @@ def a_render_start(resolve, args):
247
436
  if args["preset"] not in (p.GetRenderPresetList() or []):
248
437
  fail("no_preset", "no render preset named %r" % args["preset"], presets=p.GetRenderPresetList() or [])
249
438
  p.LoadRenderPreset(args["preset"])
439
+ if args.get("audio_tracks"): # no API key for output routing: a preset carries it
440
+ routed = _routed_settings(resolve, p, args["audio_tracks"])
250
441
  settings = {"TargetDir": target, "CustomName": args.get("name") or tl.GetName(),
251
- "ExportVideo": True, "ExportAudio": bool(args.get("audio"))}
442
+ "ExportVideo": True, "ExportAudio": bool(args.get("audio") or args.get("audio_tracks"))}
252
443
  rng = args.get("range")
253
444
  if rng:
254
445
  settings.update({"SelectAllFrames": False, "MarkIn": int(rng["in"]), "MarkOut": int(rng["out"])})
255
446
  else:
256
447
  settings["SelectAllFrames"] = True
257
- p.SetRenderSettings(settings) # may return False and still apply: never fatal
448
+ if not p.SetRenderSettings(settings):
449
+ # False when ANY key is refused, and nobody can tell what was applied: one key at a time says which
450
+ rejected = [k for k, v in settings.items() if not p.SetRenderSettings({k: v})]
258
451
  job = p.AddRenderJob()
259
452
  if not job:
260
453
  fail("render_refused", "Resolve did not queue the job (check the format/codec and target folder)")
261
454
  finally:
455
+ if routed:
456
+ p.DeleteRenderPreset(routed)
262
457
  if kept:
263
458
  p.LoadRenderPreset(keep)
264
459
  p.DeleteRenderPreset(keep)
@@ -266,8 +461,10 @@ def a_render_start(resolve, args):
266
461
  p.DeleteRenderJob(job)
267
462
  fail("render_refused", "Resolve would not start the job")
268
463
  return {"ok": True, "job_id": job, "timeline": tl.GetName(), "project": p.GetName(),
269
- "settings_restored": kept,
270
- "restore": {"timeline": prev_tl.GetName() if prev_tl else None, "page": page}}
464
+ "settings_restored": kept, "disabled_tracks": off, "audio_tracks": args.get("audio_tracks") or [],
465
+ "rejected_settings": rejected,
466
+ "restore": {"timeline": prev_tl.GetName() if prev_tl else None, "page": page,
467
+ "rendered": tl.GetName(), "tracks": off}}
271
468
 
272
469
 
273
470
  def a_render_status(resolve, args):
@@ -302,14 +499,26 @@ def a_render_cancel(resolve, args):
302
499
 
303
500
 
304
501
  def a_render_finish(resolve, args, state=None):
305
- """Remove our job from the queue and give the user back their timeline and page."""
502
+ """Give the user back their timeline and page; a finished job stays queued, a cancelled one goes."""
306
503
  _pm, p = project_or_fail(resolve)
307
504
  job = find_job(p, args["job_id"])
308
505
  out = {"ok": True, "job_id": args["job_id"], "state": state or "complete"}
309
506
  if job:
310
507
  out["output"] = os.path.join(job.get("TargetDir", ""), job.get("OutputFilename", ""))
311
- p.DeleteRenderJob(args["job_id"])
508
+ # a finished render keeps its job, so the queue records what made each file (field report 1007);
509
+ # a cancelled one is taken back out
510
+ if out["state"] == "complete":
511
+ out["job_kept"] = True
512
+ else:
513
+ p.DeleteRenderJob(args["job_id"])
312
514
  r = args.get("restore") or {}
515
+ if r.get("tracks"): # the tracks we switched off for this job, back on (Edit page, read back)
516
+ t = next((x for x in timelines(p) if x.GetName() == r.get("rendered")), None)
517
+ if t:
518
+ p.SetCurrentTimeline(t)
519
+ bad = set_video_tracks(resolve, t, r["tracks"], True)
520
+ out["tracks_restored"] = bool(t) and not bad
521
+ out["tracks"] = r["tracks"]
313
522
  if r.get("timeline"):
314
523
  for t in timelines(p):
315
524
  if t.GetName() == r["timeline"]:
@@ -395,7 +604,7 @@ def _deliver_ready(resolve, project):
395
604
  resolve.OpenPage("deliver")
396
605
  time.sleep(1.0)
397
606
  for name in project.GetRenderPresetList() or []:
398
- if name.startswith(KEEP_PREFIX):
607
+ if name.startswith((KEEP_PREFIX, ROUTE_PREFIX)):
399
608
  project.DeleteRenderPreset(name)
400
609
  return page
401
610
 
@@ -513,9 +722,226 @@ def a_markers(resolve, args):
513
722
  return {"ok": True, "timeline": t.GetName(), "placed": placed, "cleared": cleared, "skipped": skipped}
514
723
 
515
724
 
725
+ # ── render presets: read and author what the scripting API cannot set ──────────────────────
726
+ #
727
+ # The API has no key for the Deliver page's audio OUTPUT routing (which timeline track or bus feeds
728
+ # each output track) — but a render preset stores it, and Resolve exports/imports presets as XML.
729
+ # Decoded 2026-10-06 (LITTLE DYNAMO field report, Resolve 21.1; all 60 presets round-trip
730
+ # byte-exact): <FieldsBlob> is a hex Qt QDataStream map — u32 version, u32 count, then (QString key,
731
+ # QVariant value)*; QString = u32 byte length + UTF-16BE; QVariant = u32 type + u8 null + payload
732
+ # (1 bool, 2 int32, 3 uint32, 10 QString, 12 QByteArray = a nested map). Routing lives in
733
+ # RenderAudioTracks {"0": {TrackInfoType 0 = timeline track | 1 = bus, TrackInfoValue n (1-based)}, ...},
734
+ # mirrored by RecordAudioNormalizationOutputTracksEnableState and ExtraInfoMap aud_src_config
735
+ # ("TRK0:TRK1" = timeline tracks 1 and 2, "AUX0" = bus 1).
736
+
737
+ ROUTE_PREFIX = "__ct_route_"
738
+
739
+
740
+ def _qs(v):
741
+ b = v.encode("utf-16-be")
742
+ return struct.pack(">I", len(b)) + b
743
+
744
+
745
+ def _rqs(b, i):
746
+ n, = struct.unpack_from(">I", b, i)
747
+ i += 4
748
+ return (None, i) if n == 0xffffffff else (b[i:i + n].decode("utf-16-be"), i + n)
749
+
750
+
751
+ def blob_decode(b):
752
+ _ver, cnt = struct.unpack_from(">II", b, 0)
753
+ i, d = 8, {}
754
+ for _ in range(cnt):
755
+ k, i = _rqs(b, i)
756
+ t, = struct.unpack_from(">I", b, i)
757
+ i += 5
758
+ if t == 1:
759
+ v = bool(b[i]); i += 1
760
+ elif t == 2:
761
+ v, = struct.unpack_from(">i", b, i); i += 4
762
+ elif t == 3:
763
+ v, = struct.unpack_from(">I", b, i); i += 4
764
+ elif t == 10:
765
+ v, i = _rqs(b, i)
766
+ elif t == 12:
767
+ n, = struct.unpack_from(">I", b, i); i += 4
768
+ raw = b[i:i + n]; i += n
769
+ try:
770
+ v = blob_decode(raw)
771
+ except Exception:
772
+ v = raw
773
+ else:
774
+ raise ValueError("QVariant type %d for %r" % (t, k))
775
+ d[k] = v
776
+ if i != len(b):
777
+ raise ValueError("trailing bytes in FieldsBlob")
778
+ return d
779
+
780
+
781
+ def blob_encode(d, ver=1):
782
+ out = struct.pack(">II", ver, len(d))
783
+ for k, v in d.items():
784
+ out += _qs(k)
785
+ if isinstance(v, bool):
786
+ out += struct.pack(">IBB", 1, 0, v)
787
+ elif isinstance(v, int):
788
+ out += struct.pack(">IBi", 2, 0, v)
789
+ elif isinstance(v, str):
790
+ out += struct.pack(">IB", 10, 0) + _qs(v)
791
+ elif isinstance(v, dict):
792
+ raw = blob_encode(v)
793
+ out += struct.pack(">IBI", 12, 0, len(raw)) + raw
794
+ elif isinstance(v, bytes):
795
+ out += struct.pack(">IBI", 12, 0, len(v)) + v
796
+ else:
797
+ raise TypeError(k)
798
+ return out
799
+
800
+
801
+ def _xml_field(xml, k):
802
+ m = re.search(r"<%s>([^<]*)</%s>" % (k, k), xml)
803
+ return m.group(1) if m else None
804
+
805
+
806
+ def _extra(xml, k):
807
+ m = re.search(r"<DbKey>%s</DbKey>\s*<DbVal>([^<]*)</DbVal>" % re.escape(k), xml)
808
+ return m.group(1) if m else None
809
+
810
+
811
+ def _fields(xml):
812
+ m = re.search(r"<FieldsBlob>([0-9a-fA-F]*)</FieldsBlob>", xml)
813
+ return blob_decode(bytes.fromhex(m.group(1))) if m else {}
814
+
815
+
816
+ def preset_summary(xml):
817
+ """What a preset renders: container, codec, raster, audio codec and output routing."""
818
+ f = _fields(xml)
819
+ routing = []
820
+ for _k, o in sorted((f.get("RenderAudioTracks") or {}).items(), key=lambda kv: int(kv[0])):
821
+ if isinstance(o, dict):
822
+ routing.append(("Bus %d" if o.get("TrackInfoType") == 1 else "Timeline Track %d") % o.get("TrackInfoValue", 0))
823
+ return {"format": _xml_field(xml, "RecordFormatType"), "codec": _xml_field(xml, "RecordFormatSubType"),
824
+ "width": _xml_field(xml, "FormatWidth"), "height": _xml_field(xml, "FormatHeight"),
825
+ "audio": _xml_field(xml, "RecordAudioEnabled"), "audio_codec": _extra(xml, "aud_codec"),
826
+ "audio_outputs": routing, "discrete_audio": _extra(xml, "aud_discrete") == "1"}
827
+
828
+
829
+ def with_audio_tracks(xml, tracks):
830
+ """The preset with Deliver > Audio output n fed by timeline track tracks[n] (1-based), and a fresh DbId."""
831
+ m = re.search(r"<FieldsBlob>([0-9a-fA-F]*)</FieldsBlob>", xml)
832
+ if not m:
833
+ raise ValueError("not a Resolve render preset (no FieldsBlob)")
834
+ f = blob_decode(bytes.fromhex(m.group(1)))
835
+ f["RenderAudioTracks"] = dict((str(i), {"TrackInfoValue": int(n), "TrackInfoType": 0}) for i, n in enumerate(tracks))
836
+ f["RecordAudioNormalizationOutputTracksEnableState"] = dict((str(i), 1) for i in range(len(tracks)))
837
+ x = xml[:m.start(1)] + blob_encode(f).hex() + xml[m.end(1):]
838
+ x = re.sub(r"(<DbKey>aud_src_config</DbKey>\s*<DbVal>)[^<]*(</DbVal>)",
839
+ lambda g: g.group(1) + ":".join("TRK%d" % (int(n) - 1) for n in tracks) + g.group(2), x)
840
+ x = re.sub(r"<RecordAudioEnabled>[^<]*</RecordAudioEnabled>", "<RecordAudioEnabled>true</RecordAudioEnabled>", x)
841
+ return re.sub(r'DbId="[^"]+"', 'DbId="%s"' % uuid.uuid4(), x, 1)
842
+
843
+
844
+ def _export_xml(resolve, name):
845
+ d = tempfile.mkdtemp(prefix="ct_preset_")
846
+ try:
847
+ resolve.ExportRenderPreset(name, d) # a DIRECTORY; returns True regardless: trust the file
848
+ for root, _dirs, files in os.walk(d):
849
+ for fn in files:
850
+ if fn.endswith(".xml"):
851
+ with open(os.path.join(root, fn), encoding="utf-8") as fh:
852
+ return fh.read()
853
+ return None
854
+ finally:
855
+ shutil.rmtree(d, ignore_errors=True)
856
+
857
+
858
+ def _import_xml(resolve, p, xml, name):
859
+ """Import xml as preset `name` (Resolve names it after the file; no dots in ours). It also SELECTS it."""
860
+ d = tempfile.mkdtemp(prefix="ct_preset_")
861
+ try:
862
+ path = os.path.join(d, name + ".xml")
863
+ with open(path, "w", encoding="utf-8") as fh:
864
+ fh.write(xml)
865
+ resolve.ImportRenderPreset(path)
866
+ finally:
867
+ shutil.rmtree(d, ignore_errors=True)
868
+ return name in (p.GetRenderPresetList() or [])
869
+
870
+
871
+ def _routed_settings(resolve, p, tracks):
872
+ """Make the Deliver page's CURRENT settings route audio output n from timeline track tracks[n]:
873
+ snapshot → export → rewrite the routing → import (which selects it). Returns the preset to delete."""
874
+ snap = "%s%d_%d" % (ROUTE_PREFIX, os.getpid(), int(time.time() * 1000))
875
+ if not p.SaveAsNewRenderPreset(snap):
876
+ fail("render_refused", "Resolve would not snapshot the render settings to set the audio routing")
877
+ xml = _export_xml(resolve, snap)
878
+ p.DeleteRenderPreset(snap)
879
+ if not xml:
880
+ fail("render_refused", "Resolve did not export the render settings, so the audio routing cannot be set")
881
+ if not _import_xml(resolve, p, with_audio_tracks(xml, tracks), snap) or not p.LoadRenderPreset(snap):
882
+ fail("render_refused", "Resolve did not take the preset with the audio routing")
883
+ return snap
884
+
885
+
886
+ def a_presets(resolve, args):
887
+ """Every render preset (or `names`) with what it renders, including the audio output routing."""
888
+ _pm, p = project_or_fail(resolve)
889
+ page = _deliver_ready(resolve, p)
890
+ try:
891
+ want = args.get("names") or [n for n in (p.GetRenderPresetList() or []) if not n.startswith(("__ct_",))]
892
+ out = []
893
+ for n in want:
894
+ xml = _export_xml(resolve, n)
895
+ row = {"name": n}
896
+ try:
897
+ row.update(preset_summary(xml) if xml else {"error": "Resolve did not export it"})
898
+ except Exception as e:
899
+ row["error"] = "could not read: %s" % e
900
+ out.append(row)
901
+ return {"ok": True, "project": p.GetName(), "presets": out}
902
+ finally:
903
+ if resolve.GetCurrentPage() != page:
904
+ resolve.OpenPage(page)
905
+
906
+
907
+ def a_preset_author(resolve, args):
908
+ """Save a new preset = `base` (a preset, or the Deliver page's current settings) with the audio
909
+ outputs fed by timeline tracks `audio_tracks`. Never replaces an existing preset."""
910
+ _pm, p = project_or_fail(resolve)
911
+ name = args["name"]
912
+ if "." in name:
913
+ fail("invalid_args", "Resolve cuts an imported preset's name at the first dot: use a name without dots")
914
+ if name in (p.GetRenderPresetList() or []):
915
+ fail("exists", "a render preset named %r already exists; pick another name (we never replace one)" % name)
916
+ page = _deliver_ready(resolve, p)
917
+
918
+ def go():
919
+ if args.get("base"):
920
+ if args["base"] not in (p.GetRenderPresetList() or []):
921
+ fail("no_preset", "no render preset named %r" % args["base"], presets=p.GetRenderPresetList() or [])
922
+ xml = _export_xml(resolve, args["base"])
923
+ else:
924
+ snap = "%s%d" % (ROUTE_PREFIX, os.getpid())
925
+ p.SaveAsNewRenderPreset(snap)
926
+ xml = _export_xml(resolve, snap)
927
+ p.DeleteRenderPreset(snap)
928
+ if not xml:
929
+ fail("render_refused", "Resolve did not export the base settings")
930
+ if not _import_xml(resolve, p, with_audio_tracks(xml, args["audio_tracks"]), name):
931
+ fail("preset_import_failed", "Resolve did not import the new preset")
932
+ back = _export_xml(resolve, name)
933
+ return {"ok": True, "preset": name, "summary": preset_summary(back) if back else None}
934
+ try:
935
+ return _keeping_settings(p, go)
936
+ finally:
937
+ if resolve.GetCurrentPage() != page:
938
+ resolve.OpenPage(page)
939
+
940
+
516
941
  ACTIONS = {
517
942
  "version": a_version,
518
943
  "current": a_current,
944
+ "project": a_project,
519
945
  "export": a_export,
520
946
  "open": a_open,
521
947
  "render_start": a_render_start,
@@ -525,6 +951,8 @@ ACTIONS = {
525
951
  "renderplugin_preset": a_renderplugin_preset,
526
952
  "clips": a_clips,
527
953
  "markers": a_markers,
954
+ "presets": a_presets,
955
+ "preset_author": a_preset_author,
528
956
  }
529
957
 
530
958
 
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env node
2
+ import { createRequire as __conformRequire } from 'node:module'; const require = __conformRequire(import.meta.url);
3
+ import"./chunk-PSANHDZM.js";import{readFileSync as d}from"node:fs";import{join as i}from"node:path";import{homedir as h}from"node:os";var s=[255,60,0],p=[245,245,245],a=[140,140,140],$=[80,200,120],r=(t,n)=>`\x1B[38;2;${t[0]};${t[1]};${t[2]}m${n}\x1B[0m`,_=3e4,y=9e4,c="\u25D0\u25D3\u25D1\u25D2";function m(t){let n=Math.max(0,Math.round(t/1e3));return n>=3600?`${Math.floor(n/3600)}:${String(Math.floor(n/60)%60).padStart(2,"0")}:${String(n%60).padStart(2,"0")}`:`${Math.floor(n/60)}:${String(n%60).padStart(2,"0")}`}function M(t,n,e=8){let o=n>0?Math.min(e,Math.round(e*t/n)):0;return r(s,"\u25B0".repeat(o))+r(a,"\u25B1".repeat(e-o))}function S(t,n){if(!t)return"";let e=t.verb.replace(/^timeline_|^media_/,"");if(t.status==="running"){if(n-Date.parse(t.updated_at)>_)return"";let f=r(s,c[Math.floor(n/250)%c.length]),g=t.total>0?`${t.done}/${t.total}`:"",b=t.phase&&t.phase!=="starting"?t.phase.replace(/\s*\d+\/\d+.*$/,"").slice(0,32):"";return[`${f} ${r(p,e)}`,t.total>0?M(t.done,t.total):"",r(a,[g,b,m(n-Date.parse(t.started_at))].filter(Boolean).join(" \xB7 "))].filter(Boolean).join(" ")}let o=Date.parse(t.finished_at??t.updated_at);if(n-o>y)return"";let u=m(o-Date.parse(t.started_at));return t.status==="done"?r($,`\u2713 ${e} done`)+r(a,` \xB7 ${u}`):r(s,`\u2717 ${e} ${t.status}`)+r(a,` \xB7 ${u}`)}function R(t){let n=t.now??Date.now();return[r(s,"\u25C9")+" "+r(p,"conform.tools"),t.facility?r(a,t.facility):"",S(t.job,n),t.model?r(a,t.model):""].filter(Boolean).join(r(a," \xB7 "))}function l(t){try{return JSON.parse(d(t,"utf8"))}catch{return null}}function B(){let t=process.env.CONFORM_MCP_HOME??i(h(),".conform-mcp"),n=null;try{let o=d(0,"utf8");n=o.trim()?JSON.parse(o):null}catch{}let e=l(i(t,"profile.json"))??l(i(t,"naming.json"));process.stdout.write(R({job:l(i(t,"jobs",".current")),facility:e?.facility||void 0,model:n?.model?.display_name})+`
4
+ `)}(import.meta.main??/statusline\.(js|ts)$/.test(process.argv[1]??""))&&B();export{M as bar,m as clock,S as jobPart,B as main,R as statusLine};
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ import{readFileSync as d}from"node:fs";import{join as i}from"node:path";import{homedir as h}from"node:os";var s=[255,60,0],p=[245,245,245],a=[140,140,140],$=[80,200,120],r=(t,n)=>`\x1B[38;2;${t[0]};${t[1]};${t[2]}m${n}\x1B[0m`,_=3e4,y=9e4,c="\u25D0\u25D3\u25D1\u25D2";function m(t){let n=Math.max(0,Math.round(t/1e3));return n>=3600?`${Math.floor(n/3600)}:${String(Math.floor(n/60)%60).padStart(2,"0")}:${String(n%60).padStart(2,"0")}`:`${Math.floor(n/60)}:${String(n%60).padStart(2,"0")}`}function M(t,n,e=8){let o=n>0?Math.min(e,Math.round(e*t/n)):0;return r(s,"\u25B0".repeat(o))+r(a,"\u25B1".repeat(e-o))}function S(t,n){if(!t)return"";let e=t.verb.replace(/^timeline_|^media_/,"");if(t.status==="running"){if(n-Date.parse(t.updated_at)>_)return"";let f=r(s,c[Math.floor(n/250)%c.length]),g=t.total>0?`${t.done}/${t.total}`:"",b=t.phase&&t.phase!=="starting"?t.phase.replace(/\s*\d+\/\d+.*$/,"").slice(0,32):"";return[`${f} ${r(p,e)}`,t.total>0?M(t.done,t.total):"",r(a,[g,b,m(n-Date.parse(t.started_at))].filter(Boolean).join(" \xB7 "))].filter(Boolean).join(" ")}let o=Date.parse(t.finished_at??t.updated_at);if(n-o>y)return"";let u=m(o-Date.parse(t.started_at));return t.status==="done"?r($,`\u2713 ${e} done`)+r(a,` \xB7 ${u}`):r(s,`\u2717 ${e} ${t.status}`)+r(a,` \xB7 ${u}`)}function R(t){let n=t.now??Date.now();return[r(s,"\u25C9")+" "+r(p,"conform.tools"),t.facility?r(a,t.facility):"",S(t.job,n),t.model?r(a,t.model):""].filter(Boolean).join(r(a," \xB7 "))}function l(t){try{return JSON.parse(d(t,"utf8"))}catch{return null}}function B(){let t=process.env.CONFORM_MCP_HOME??i(h(),".conform-mcp"),n=null;try{let o=d(0,"utf8");n=o.trim()?JSON.parse(o):null}catch{}let e=l(i(t,"profile.json"))??l(i(t,"naming.json"));process.stdout.write(R({job:l(i(t,"jobs",".current")),facility:e?.facility||void 0,model:n?.model?.display_name})+`
3
+ `)}(import.meta.main??/statusline\.(js|ts)$/.test(process.argv[1]??""))&&B();export{M as bar,m as clock,S as jobPart,B as main,R as statusLine};
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ import { createRequire as __conformRequire } from 'node:module'; const require = __conformRequire(import.meta.url);
3
+ import{a as n,e as s,f as o}from"./chunk-6FVGUJ6L.js";import{a as l}from"./chunk-UCMNH6Q6.js";import"./chunk-PSANHDZM.js";var u=r=>{let e=r.split(/[/\\]/).pop()??"",t=e.lastIndexOf(".");return t>0?e.slice(t+1).toLowerCase():""};async function f(r,e){try{if(r==="dpx"){let t=await(await import("./dpx-wasm-AHH7D56L.js")).inspectDpxWasm(e);return t?{width:t.width,height:t.height}:null}if(r==="exr"){let t=await(await import("./exr-wasm-3TAN64WQ.js")).inspectExrWasm(e);return t?{width:t.width,height:t.height}:null}if(r==="dng"){let t=await(await import("./dng-wasm-2I7S2SN4.js")).inspectDngWasm(e);return t?{width:t.width,height:t.height}:null}if(r==="cr3"){let t=await(await import("./cr3-wasm-HTRSUBJK.js")).inspectCr3Wasm(e);return t?{width:t.width,height:t.height}:null}if(r==="tif"||r==="tiff"){let t=await(await import("./tiff-wasm-6XFTTCL4.js")).inspectTiffWasm(e);return t?{width:t.width,height:t.height}:null}}catch{}return null}async function p(r){if(typeof createImageBitmap!="function"||typeof Blob>"u")return null;try{let e=await createImageBitmap(new Blob([r])),t={width:e.width,height:e.height};return e.close?.(),t.width>0&&t.height>0?t:null}catch{return null}}async function m(r){let e=u(r.filename),t=await o(e,s(r));if(t)return t;let i=l(e);if(i===null||i==="none")return null;let a;try{a=await r.read(0,r.fileSize)}catch{return null}return i==="wasm-decoder"?await f(e,a):await p(a)}function c(r){let e=n(r);return e==="jpg"?"jpeg":e==="tif"?"tiff":e||"still"}var _={async inspect(r){let e=r.parts[0],t=await m(e);return{id:e.filename,kind:"external",content_kind:"still",target_url:e.filename,available_range:null,reel_name:null,source_timecode:null,container:n(e.filename)||"still",codec:c(e.filename),size_bytes:e.fileSize,bitrate_bps:null,source_resolution_w:t?.width??null,source_resolution_h:t?.height??null,source_pixel_aspect:t?1:null,streams:[],vendor_metadata:{},binding_state:"unbound",raw_extraction:{},metadata:{}}},async extract(r){let e=r.parts.map((t,i)=>({kind:"frame",part:i,offset:0,length:t.fileSize,frame_in:i,frame_out:i}));return e.length===0?null:{v:1,container:n(r.parts[0].filename)||"still",codec:c(r.parts[0].filename),frame_count:e.length,granularity:"frame",segments:e,...r.parts.length>1?{part_names:r.parts.map(t=>t.filename)}:{}}},async sparsify(){throw new Error("stillFormat.sparsify: stills ship whole \u2014 no sparse plan exists")},async trim(){throw new Error("stillFormat.trim: stills ship whole \u2014 no trim plan exists")}};export{_ as stillFormat};