Installation

Installation

stepshot targets KDE Plasma on Wayland. You need a KDE session (KWin) for the screenshots, and membership in the input group for click capture — see Requirements and Permissions.

Option A — build from source

Requirements: a Rust toolchain (rustc/cargo, stable) and the KDE/Wayland session at runtime.

git clone https://github.com/joshii-h/stepshot.git
cd stepshot
./install.sh

install.sh:

• builds the release binary (cargo build --release),
• installs it to ~/.local/bin/stepshot,
• installs the icon to ~/.local/share/icons/hicolor/scalable/apps/,
• writes the .desktop file to ~/.local/share/applications/ (this also grants KWin screenshot authorization — see Requirements and Permissions),
• refreshes the menu/icon caches,
• warns if you are not yet in the input group.

Option B — prebuilt release (no toolchain)

Download the latest tarball from the Releases page (prebuilt x86_64 / glibc binary), then:

tar xzf stepshot-*.tar.gz && cd stepshot-*/
./install.sh        # installs the bundled binary + icon + .desktop

Here install.sh uses the bundled binary instead of compiling.

After installing

1. Make sure you are in the input group and reboot — see Requirements and Permissions.
2. Launch stepshot from the application menu (or run stepshot). It appears as a camera icon in the system tray.

The installer copies the binary (it does not symlink it). KWin authorizes screenshots by matching the running executable's path against the Exec= line in the .desktop file, so the binary must live at that exact path.

Uninstall

rm -f ~/.local/bin/stepshot \
      ~/.local/share/icons/hicolor/scalable/apps/stepshot.svg \
      ~/.local/share/applications/org.stepshot.Stepshot.desktop

Removing the .desktop file also revokes KWin screenshot authorization.