garshot Public

Notifications Fork 0 Star 0
trunk
Branches trunk Tags v0.1.0 v0.2.0 v0.2.1
1 Branches 3 Tags
Go to file T
Code
espadonne Fix tilde expansion in config save_dir path
f44f052 66 Commits
garshot Fix tilde expansion in config save_dir path
garshot-ipc add garshot-ipc crate with IPC protocol types
garshotctl add garshotctl CLI control tool
.gitignore ignore docs directory
Cargo.lock update Cargo.lock
Cargo.toml bump version to 0.2.0
README.md add delay timer, desktop notifications, and stdout output

garshot

X11 screenshot utility for the gar desktop suite.

Features

  • Full screen, region, window capture
  • Interactive selection with blur overlay
  • Multi-monitor support (XRandR)
  • Output formats: PNG, JPEG, WebP
  • Auto-copy to clipboard
  • Optional cursor capture
  • MIT-SHM for fast screen capture

Dependencies

Build:

  • Rust 1.85+
  • libxcb, libx11
  • cairo

Runtime:

  • X11
  • xclip (for clipboard)
  • libnotify (for --notify, optional)

Fedora/RHEL

sudo dnf install libxcb-devel libX11-devel cairo-devel xclip libnotify

Debian/Ubuntu

sudo apt install libxcb1-dev libx11-dev libcairo2-dev xclip libnotify-bin

Arch

sudo pacman -S libxcb libx11 cairo xclip libnotify

Build

cargo build --release

Binary at target/release/garshot.

Install

cargo install --path garshot

Or copy manually:

sudo install -Dm755 target/release/garshot /usr/local/bin/garshot

Usage

Full screen

garshot screen                     # All monitors
garshot screen -m DP-1             # Specific monitor
garshot screen -c                  # Include cursor
garshot screen -f jpeg -o shot.jpg # JPEG output
garshot screen --delay 3           # 3 second countdown
garshot screen --notify            # Desktop notification on save
garshot screen -o - | feh -        # Pipe to viewer

Interactive selection

garshot select                     # Blur overlay, drag to select
garshot select -b 20               # Custom blur radius

Controls:

  • Left click + drag: select region
  • Right click / Escape: cancel
  • Release: capture

Window capture

garshot window                     # Active window
garshot window -i 0x1400007        # By window ID
garshot window -d                  # Include decorations

Region by geometry

garshot region -g 800x600+100+50   # WxH+X+Y format

List monitors

garshot monitors

Common options

Option Description
-o, --output <PATH> Output file path (use - for stdout)
-f, --format <FMT> png, jpeg, webp (default: png)
-c, --cursor Include cursor in capture
--no-clipboard Don't copy to clipboard
--delay <SECS> Delay before capture (screen/region/window)
--notify Show desktop notification on save

Configuration

Config file: ~/.config/garshot/config.toml

[general]
save_dir = "~/Pictures/Screenshots"
format = "png"
quality = 90
include_cursor = false

[selection]
blur_radius = 15
line_color = "#ff6600"
line_width = 2

[naming]
pattern = "screenshot-%Y%m%d-%H%M%S"

Keybindings (gar)

Add to ~/.config/gar/init.lua:

gar.bind("ctrl+shift+4", function()
    gar.exec("garshot select")
end)
gar.bind("ctrl+shift+5", function()
    gar.exec("garshot screen")
end)
gar.bind("ctrl+shift+6", function()
    gar.exec("garshot window")
end)

Environment

  • RUST_LOG=debug - Enable debug logging

License

MIT