Skip to content

v0.3.0 — first public build

Choose a tag to compare

View all tags
@BkashJEE BkashJEE released this 28 Sep 17:18
· 179 commits to main since this release
v0.3.0
4e85e3a

v0.3.0 — first public build

The first release of the Omarchy edition.

Install

curl -fsSL https://github.com/BkashJEE/screenpolish-omarchy/releases/latest/download/ScreenPolish-0.3.0-installer.run -o sp.run
chmod +x sp.run
./sp.run

The installer checks your session, asks where to put the app, writes the menu
entry, and offers to install gpu-screen-recorder and add you to the input
group. ./sp.run --uninstall removes exactly what it installed and leaves your
recordings alone.

Prefer a package? ScreenPolish-0.3.0.pacman for Arch and Omarchy,
ScreenPolish-0.3.0.AppImage for anything else.

Windows. Run ScreenPolish-Setup-0.3.0.exe and choose where it goes. It is
not code signed, so SmartScreen says "Windows protected your PC": click
More info, then Run anyway. Defender may also quarantine it. That is
what an unsigned installer looks like, not a broken download.

macOS. Unzip ScreenPolish-0.3.0-mac.zip, move the app where you want it,
and clear the quarantine flag macOS puts on unsigned software:

xattr -dr com.apple.quarantine /Applications/ScreenPolish.app

Without that, macOS reports the app as damaged. It is not. This is an x64
build, so Apple Silicon runs it through Rosetta 2.

Checksums for every file are in SHA256SUMS.txt.

What it does

  • Records a screen, window or region through gpu-screen-recorder: no share
    dialog, and the system cursor never enters the video
  • Builds zooms from the clicks recorded with the take, and glides back out
  • Draws the pointer it recorded: arrow, hand, dot or bobbing, with ripples,
    optional click sounds, and a fade while it rests
  • Cut, split, transitions, silence removal, speed, crop
  • Blur or pixelate, arrows, highlight boxes, text and image overlays
  • Backgrounds, a unified 3D frame, browser/window/phone mockups
  • Webcam bubble with background removal
  • Captions transcribed locally with whisper.cpp and burned in at export
  • MP4 or GIF up to 2160p at 60 fps, in 16:9, 9:16, 1:1 or the source shape
  • A music shelf: drop audio into ~/Music/ScreenPolish and it is one click away
  • record, clip and export from the command line, answering with JSON

Requirements

Wayland, and Hyprland for cursor-free capture — without it, capture falls back
to the desktop portal, which bakes the system cursor into the video. Clicks
need membership of the input group; without it there is no click log and
automatic zoom has nothing to work from. The installer checks both.

Known limits

  • Cursor-free capture is Hyprland only. On Windows and macOS the system
    cursor is captured into the video, so the drawn pointer styles have nothing
    to replace. Recording, zoom, editing, effects and export work everywhere.
  • Offline captions are bundled on Linux only.
  • The Windows and macOS builds are unsigned, and the macOS build is x64.
  • Captions are English, with the bundled base model.
  • Encoding falls back to the CPU where a GPU encoder is unavailable.
  • This build has been tested by one person. Please open issues.

Privacy

Recordings, input logs and projects live in your recordings folder, by default
~/Videos/ScreenPolish. Nothing else is written, nothing is uploaded, and
there is no network code in the app.

Assets 8
Loading