programmers-screenshot 0.25.0

programmers-screenshot (0.25.0) noble; urgency=medium

• A screenshot can now be described rather than taken by hand, so that
  something other than a person can produce one. --recipe takes JSON naming
  a region, a delay, an output path and a list of marks: boxes, ellipses,
  lines, arrows, numbered step badges, labels, redaction bars and
  pixelation, in the colours and sizes the toolbar already offers. Nothing
  is drawn until the whole recipe has been understood, so a mistake in the
  last arrow does not leave the first three baked into a half-finished
  image; the message names the entry and the exit status is 2.
• --recipe-help prints the whole reference, generated from the parser's own
  table so it cannot go stale, and needs no display.
• --region X,Y,W,H captures an area with no overlay, and --delay N waits
  before the screen is read, so a menu or a hover state can be set up first.
  The delay works with the overlay too.
• --window TITLE captures one window whatever is stacked on top of it.
  Nothing is raised and nothing is focused: under a compositor every window
  is drawn to an offscreen pixmap of its own, so a completely buried window
  can be photographed without disturbing it, and whatever is lying over it
  stays out of the picture. --list-windows says what can be named. X11 only,
  and it wants libwnck.
• --input FILE annotates a picture something else took, with --scale for the
  size it came out at and --origin to move where coordinates start. This is
  how a browser tab is done: nothing outside a browser can address a tab, so
  the browser captures the tab it means and this annotates the result, with
  every coordinate the page's own.
• --install-skill writes a Claude Code skill, so that a session in any
  project knows the command exists and how to drive it. --uninstall-skill
  takes it back.
• All of it is off until switched on, in the settings window, for the same
  reason the update check is: a person pressing Print Screen knows what is
  on their screen and a script does not. Annotating a picture with --input
  is exempt, since it reads no screen at all.
• Fix: a stray copy of the file list had been pasted into the middle of the
  --install-hotkey paragraph of the man page, splitting a sentence in two.

-- Shubshub Wed, 02 Sep 2026 14:20:00 +1200