Skip to content

The truly free, open-source, local-first, cross-platform CapCut replacement. Scriptable through a JSON-RPC API & MCP.

updates

Jareerfa15ba9d00af
diff --git a/scripts/editor-preview-sop.md b/scripts/editor-preview-sop.md
new file mode 100644
index 00000000..b5c0216d
--- /dev/null
+++ b/scripts/editor-preview-sop.md
@@ -0,0 +1,41 @@
+# SOP: updating the README hero screenshot
+
+The image at the top of `README.md` is `assets/editor-preview.png` — a single
+frame that is the **dark theme on the left half** and the **light theme on the
+right half**, joined at the vertical center line. Because both screenshots show
+the identical window state, the seam falls invisibly through the middle of the
+preview pane.
+
+## Steps
+
+1. **Run the app** — `cd desktop && npm run app`. Stage something presentable:
+ a clip in the media bin, a couple of tracks on the timeline, the playhead
+ somewhere interesting. Avoid personal file names in the media panel.
+
+2. **Take the dark screenshot.** With the app in dark theme, press
+ `⌘⇧4`, then `Space`, then click the WolfCut window (captures just the
+ window). Don't move or resize the window after this.
+
+3. **Switch to light theme** (the sun/moon toggle in the title bar) and take
+ the second screenshot the same way. **Don't touch anything else** — same
+ window size, same panels, same playhead. Any drift shows at the seam.
+
+4. **Build the split:**
+
+ ```sh
+ scripts/make-editor-preview.sh ~/Desktop/Screenshot*<time1>*.png ~/Desktop/Screenshot*<time2>*.png
+ ```
+
+ First argument is the **dark** screenshot, second is the **light** one.
+ Tab-complete or glob the paths — macOS puts a narrow no-break space before
+ "AM"/"PM" in screenshot names, so a hand-typed regular space won't match.
+
+ The script verifies both images are the same size, copies them to
+ `assets/screenshot-dark.png` / `assets/screenshot-light.png`, and writes
+ `assets/editor-preview.png`.
+
+5. **Check the result** — open `assets/editor-preview.png` and look at the
+ center seam. If panels are misaligned, retake both screenshots.
+
+6. **Commit** the three changed files in `assets/`. The README references
+ `assets/editor-preview.png` by path, so no README edit is needed.
diff --git a/scripts/make-editor-preview.sh b/scripts/make-editor-preview.sh
new file mode 100755
index 00000000..14e8b17d
--- /dev/null
+++ b/scripts/make-editor-preview.sh
@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# Build the README hero image: left half dark theme, right half light theme.
+#
+# Usage:
+# scripts/make-editor-preview.sh <dark-screenshot.png> <light-screenshot.png>
+#
+# Writes into assets/:
+# screenshot-dark.png copy of the dark-theme screenshot
+# screenshot-light.png copy of the light-theme screenshot
+# editor-preview.png the split image referenced by README.md
+#
+# Both screenshots must be the same size, taken of the same window state,
+# so the seam lands cleanly. Needs ffmpeg on PATH.
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+OUT="$REPO_ROOT/assets"
+
+if [[ $# -ne 2 ]]; then
+ echo "usage: $0 <dark-screenshot.png> <light-screenshot.png>" >&2
+ exit 1
+fi
+DARK="$1"
+LIGHT="$2"
+
+for f in "$DARK" "$LIGHT"; do
+ if [[ ! -f "$f" ]]; then
+ echo "error: not found: $f" >&2
+ echo "hint: macOS screenshot names contain a narrow no-break space before AM/PM;" >&2
+ echo " tab-complete the path or use a glob like ~/Desktop/Screenshot*5.28.18*.png" >&2
+ exit 1
+ fi
+done
+
+command -v ffmpeg >/dev/null 2>&1 || { echo "error: ffmpeg not on PATH" >&2; exit 1; }
+
+dims() { ffprobe -v error -select_streams v:0 -show_entries stream=width,height -of csv=p=0 "$1"; }
+d1="$(dims "$DARK")"; d2="$(dims "$LIGHT")"
+if [[ "$d1" != "$d2" ]]; then
+ echo "error: size mismatch — dark is ${d1}, light is ${d2}; retake so both match" >&2
+ exit 1
+fi
+
+cp "$DARK" "$OUT/screenshot-dark.png"
+cp "$LIGHT" "$OUT/screenshot-light.png"
+
+ffmpeg -y -v error \
+ -i "$OUT/screenshot-dark.png" -i "$OUT/screenshot-light.png" \
+ -filter_complex "[0:v]crop=iw/2:ih:0:0[left];[1:v]crop=iw/2:ih:iw/2:0[right];[left][right]hstack" \
+ -frames:v 1 "$OUT/editor-preview.png"
+
+echo "wrote $OUT/screenshot-dark.png"
+echo "wrote $OUT/screenshot-light.png"
+echo "wrote $OUT/editor-preview.png (${d1%,*}x${d1#*,})"