When to Use
Use when polishing a screen recording / demo video for sharing, when the user mentions Screen Studio, auto-zoom, idle speed-up, or vertical/social video from a screen capture, and for any social-facing demo (vertical output is the default for those).
Source: connerkward/screenstudio-alternative-skill (MIT).
screenstudio-alt
The skill's code lives in this directory (polish.py, render.py, studio.py,
events-log.swift, test fixtures, etc.). Published publicly as
connerkward/screen-studio-alternative via the publish-skill skill.
Two components:
events-log (Swift) — capture-side input logger (cursor 60Hz, clicks, keys;
drops keys during macOS secure input). Runs ONLY while recording. Needs
Accessibility/Input Monitoring for the terminal. Auto-zoom/keys/cursor need
this data at capture time — it cannot be recovered from pixels later.
polish.py (Python, ffmpeg + PIL) — the post-production pass:
python3 src/polish.py in.mp4 --events in.events.jsonl \
--speedup # compress idle (input-gap ∩ frozen-pixels; animations stay 1x)
--zoom # eased auto-zoom on click clusters (zoompan)
--keys # accumulating keystroke chips (PIL overlays, no drawtext dep)
--smooth-cursor # synthetic eased cursor (best with sck-record --no-cursor)
--vertical # ALSO emit 1080x1920 following the action
--speedup works WITHOUT events (freezedetect only) — usable on the whole
existing dailies corpus.
render.py — high-quality non-destructive renderer (preferred): single-pass
spring-physics camera over the original high-res frames, LANCZOS into a smaller
target (crisp zoom, ~1.3× sharper than the ffmpeg upscale path), 60fps, H + 9:16 V.
Tunable --freq/--zeta (spring), --fps, --target-w. Takes explicit
--regions [{t0,t1,z,cx,cy}]. polish.py is the older ffmpeg-filter fallback.
studio.py [recording.mp4] — local web UI, NLE-style fixed-ruler timeline (bar =
source duration, never rescales → upstream always planted): zoom regions are draggable
blocks (move / retime edges / click to add / double-click delete); idle spans are
speed blocks with rate-only editing — source range locked, rate set via inspector
slider on select or right-edge rate-stretch drag (FCP retime / Premiere Rate
Stretch); rate changes ripple downstream only. Tunable cosine-ease ramp, default zoom,
aspect, frame styling. Always-smooth synthetic cursor + click ripple + real recorded
click sound (CC0 #735771). Export uses render.py. Free port, local. (Keystroke overlay
exists in the engine but is off by default.)
Easy path
screencast.sh --demo (screencast skill) does the whole chain: starts the event
logger, records, then polishes + emits the 9:16 vertical automatically. Vertical
is the DEFAULT for social-facing demos.
Gotchas (learned the hard way, kept here so they're not relearned)
- ffmpeg CANNOT do animated
scale=eval=frame → crop (link reinit wedges crop's
per-frame exprs). That's why zoom uses zoompan (no t var there — use on/FPS).
- This machine's ffmpeg lacks
drawtext; all text/cursor overlays are PIL-rendered
PNGs + overlay.
- Test rig:
make-fixture.py synthesizes a fake screen recording + ground-truth
events.jsonl — validate any change against it before trusting real footage.
Limitations
- The workflow assumes FFmpeg plus the companion scripts are available locally; it is not a hosted video editor.
- Polished cursor, click, and keystroke effects depend on event logs captured during recording; missing logs limit what can be reconstructed.
- Auto-zoom and idle speed-up still need human review for pacing, framing, and platform-specific taste.
1---2name: screenstudio-alt3description: "Open-source headless Screen Studio alternative: auto speed-up of idle, auto-zoom on click clusters, keystroke overlay chips, smoothed synthetic cursor, and 9:16 vertical export that follows the action — post-production for screen recordings from the CLI."4risk: critical5source: community6source_type: community7source_repo: connerkward/screenstudio-alternative-skill8date_added: "2026-06-16"9author: Conner K Ward10license: MIT11tags:12 - screen-recording13 - video14 - post-production15 - auto-zoom16 - vertical-video17 - ffmpeg18tools:19 - claude-code20 - antigravity21 - cursor22 - gemini-cli23 - codex-cli24plugin:25 targets:26 codex: blocked27 claude: blocked28 setup:29 type: manual30 summary: "Screen/input capture requires sensitive local permissions; keep out of plugin-safe bundles."31 docs: SKILL.md32metadata:33 source: https://skillmd.com/skills/connerkward/screenstudio-alt34---3536## When to Use3738Use when polishing a screen recording / demo video for sharing, when the user mentions Screen Studio, auto-zoom, idle speed-up, or vertical/social video from a screen capture, and for any social-facing demo (vertical output is the default for those).3940_Source: [connerkward/screenstudio-alternative-skill](https://github.com/connerkward/screenstudio-alternative-skill) (MIT)._4142# screenstudio-alt4344The skill's code lives in this directory (`polish.py`, `render.py`, `studio.py`,45`events-log.swift`, test fixtures, etc.). Published publicly as46`connerkward/screen-studio-alternative` via the publish-skill skill.4748Two components:4950- `events-log` (Swift) — capture-side input logger (cursor 60Hz, clicks, keys;51 drops keys during macOS secure input). Runs ONLY while recording. Needs52 Accessibility/Input Monitoring for the terminal. **Auto-zoom/keys/cursor need53 this data at capture time — it cannot be recovered from pixels later.**54- `polish.py` (Python, ffmpeg + PIL) — the post-production pass:5556```bash57python3 src/polish.py in.mp4 --events in.events.jsonl \58 --speedup # compress idle (input-gap ∩ frozen-pixels; animations stay 1x)59 --zoom # eased auto-zoom on click clusters (zoompan)60 --keys # accumulating keystroke chips (PIL overlays, no drawtext dep)61 --smooth-cursor # synthetic eased cursor (best with sck-record --no-cursor)62 --vertical # ALSO emit 1080x1920 following the action63```6465`--speedup` works WITHOUT events (freezedetect only) — usable on the whole66existing dailies corpus.6768- `render.py` — **high-quality non-destructive renderer** (preferred): single-pass69 spring-physics camera over the original high-res frames, LANCZOS into a smaller70 target (crisp zoom, ~1.3× sharper than the ffmpeg upscale path), 60fps, H + 9:16 V.71 Tunable `--freq`/`--zeta` (spring), `--fps`, `--target-w`. Takes explicit72 `--regions [{t0,t1,z,cx,cy}]`. `polish.py` is the older ffmpeg-filter fallback.73- `studio.py [recording.mp4]` — local web UI, **NLE-style fixed-ruler timeline** (bar =74 source duration, never rescales → upstream always planted): zoom regions are draggable75 blocks (move / retime edges / click to add / double-click delete); idle spans are76 **speed blocks with rate-only editing** — source range locked, rate set via inspector77 slider on select or right-edge **rate-stretch** drag (FCP retime / Premiere Rate78 Stretch); rate changes ripple downstream only. Tunable cosine-ease ramp, default zoom,79 aspect, frame styling. Always-smooth synthetic cursor + click ripple + real recorded80 click sound (CC0 #735771). Export uses render.py. Free port, local. (Keystroke overlay81 exists in the engine but is off by default.)8283## Easy path8485`screencast.sh --demo` (screencast skill) does the whole chain: starts the event86logger, records, then polishes + emits the 9:16 vertical automatically. Vertical87is the DEFAULT for social-facing demos.8889## Gotchas (learned the hard way, kept here so they're not relearned)9091- ffmpeg CANNOT do animated `scale=eval=frame` → `crop` (link reinit wedges crop's92 per-frame exprs). That's why zoom uses `zoompan` (no `t` var there — use `on/FPS`).93- This machine's ffmpeg lacks `drawtext`; all text/cursor overlays are PIL-rendered94 PNGs + `overlay`.95- Test rig: `make-fixture.py` synthesizes a fake screen recording + ground-truth96 events.jsonl — validate any change against it before trusting real footage.9798## Limitations99100- The workflow assumes FFmpeg plus the companion scripts are available locally; it is not a hosted video editor.101- Polished cursor, click, and keystroke effects depend on event logs captured during recording; missing logs limit what can be reconstructed.102- Auto-zoom and idle speed-up still need human review for pacing, framing, and platform-specific taste.