Skip to content

v0.4.0 — MIT, a replay buffer, and the bugs that made it look broken

Choose a tag to compare

@BkashJEE BkashJEE released this 08 Oct 00:24
· 128 commits to main since this release
1d0dd8d

ScreenPolish is now MIT licensed, and this release fixes the three bugs that made the app look broken when it wasn't.

It is MIT now

v0.3.0 was AGPL. Everything from here is MIT — use it, change it, ship it in whatever you like, commercial or not.

The installers still bundle ffmpeg, which is GPL-3.0 and stays that way. That covers the bundled binary, not this project's code; its licence and source are listed in THIRD_PARTY_NOTICES.md.

New

Replay buffer. Hold the last N seconds of the screen in memory, writing nothing until you ask for it. Every other way of recording needs you to decide beforehand that something is worth filming — this one doesn't. You notice the bug, and it's still there.

Start a 30-second buffer from the tray, then Ctrl+Shift+B saves whatever it's holding, from anywhere, and tells you what it wrote. Or from the terminal:

polish replay start --seconds 30
polish replay save
polish replay stop

An MCP server, so an agent can film its own work — start a recording, do the thing, stop, get an MP4 back. Ten tools, including the replay buffer. Setup is in mcp/README.md.

Speed ramps. A speed region can ease in and out instead of changing in a single frame. That step is the most obvious tell that a demo has been edited.

Six more music tracks, now twelve. The new ones run two and a half to three and a half minutes, because a demo outlasts a ninety-second loop. Every note is computed rather than sampled, so nothing is licensed from anyone.

Eight more backgrounds, now nine, plus 20 solid and 25 gradient presets. Mesh washes, a ruled grid and a spotlight, drawn by a script and reproducible from a seed.

Offline captions on Windows and macOS.

Fixed

The CLI started a second copy of the app instead of talking to the first. This was behind a lot of it: exports that hung forever, quit that wouldn't quit, open showing a blank window, the library hanging. Three commands in a row could leave three apps fighting over the same recordings.

Pointer smoothing lagged. The filter could only use the past, so the drawn pointer trailed the real one — about a quarter of a second at full strength. It now runs forwards and then backwards, so the delay of one pass cancels the other: roughly 20 ms, and it no longer varies with how fast you move.

A failed export left a file that looked finished. Exports wrote straight to the final filename, so a 0-byte .mp4 appeared the moment one began and stayed there if it died. They now write to a part file and take the real name only on success — and an export that produced nothing says so instead of saving silence.

The tray icon crashed the Omarchy bar. The icon was republished on every recording state change, which was enough to take quickshell down with it — four times during two short recordings.

The ghost pointer lagged behind your hand on Windows and macOS. Over the recording controls it froze for a quarter of a second and then crawled along at 25 updates a second, so you clicked the stop button while it was still somewhere else. It now catches up in 60 ms, moves 60 times a second, and disappears the moment you switch screens.

A failed MP4 conversion could delete the recording. On Linux a take is saved as screen.mkv and converted when you stop. If the conversion died partway (a full disk, say), the library showed a broken file while the good copy stayed hidden. If it failed before writing anything, the whole folder was deleted, good copy included. The conversion now finishes in a separate file before it takes the real name, and a folder holding the original is never removed. If conversion fails you're told exactly where the take is.

Recording onto a full drive failed silently. Recording now refuses to start below 256 MB free, and warns below 2 GB.

A saved replay could come back half-written, and the tray menu could show the buffer as running after it had stopped.

Electron 41.10.7, which is where the extract-zip advisories actually end.

Install

Linux — .AppImage, or .pacman for Arch.
Windows — ScreenPolish Setup 0.4.0.exe. Unsigned, so Windows will warn: More info → Run anyway.
macOS — .dmg or .zip, Intel and Apple Silicon. Unsigned.

Cursor-free capture on Linux needs gpu-screen-recorder on PATH.

Known

The replay buffer is Linux only — it rides gpu-screen-recorder. There is no replay control inside the editor window; the tray and the shortcut are how you reach it.