Skip to content

Install Shotty

Requirements

  • macOS 26 (Tahoe) or newer. The Package.swift's .macOS(.v26) floor will refuse to build on older releases. Earlier macOS versions may well work — nobody has tried — but the project won't pretend to support what hasn't been verified.
  • The Swift toolchain — xcode-select --install is enough; no full Xcode required.

From source

git clone https://codeberg.org/filipsalo/shotty
cd shotty
make build
cp .build/release/shotty /usr/local/bin/

make build produces a release binary at .build/release/shotty. Anywhere on your PATH works for the destination — ~/bin, ~/.local/bin, /opt/homebrew/bin, whatever you prefer over /usr/local/bin.

Verify

shotty --help

…should print the usage. Try a quick shot:

shotty "ls -la"

If a Shotty <date> <time>.png appears in the currnet directory, you're set. Continue with Quickstart.

Updating

cd shotty
git pull
make build
cp .build/release/shotty /usr/local/bin/

Uninstall

rm /usr/local/bin/shotty

That's it — Shotty doesn't write anywhere else on disk except your chosen output PNG paths.

Optional: per-user defaults

If you've got styling preferences you want applied to every project, drop a shotty.toml at ~/.config/shotty/shotty.toml. See Configuration for how the user-wide and project-local files interact.