A Wayland native snapshot and editor tool, inspired by Snappy on macOS. Works great with grim, slurp and sway. But can easily work with other screen copy tools that can output a final image to stdout. See below.

Output of grim (or any tool outputting an image file):

grim -g "$(slurp)" - | swappy -f -

Swappshot a PNG file:

swappy -f "~/Desktop/my-gnome-saved-file.png"

Print final surface to stdout (useful to pipe with other tools):

grim -g "$(slurp)" - | swappy -f - -o - | pngquant -

Grab a swappshot from a specific window under Sway, using swaymsg and jq:

grim -g "$(swaymsg -t get_tree | jq -r '.. | select(.pid? and .visible?) | .rect | "\(.x),\(.y) \(.width)x\(.height)"' | slurp)" - | swappy -f -

The config file is located at $XDG_CONFIG_HOME/swappy/config or at $HOME/.config/swappy/config.

The file follows the GLib conf format. See the man page for details. There is example config file here.

The following lines can be used as swappy's default:

[Default]
save_dir=$HOME/Desktop
save_filename_format=swappy-%Y%m%d-%H%M%S.png
show_panel=false
line_size=5
text_size=20
text_font=sans-serif
paint_mode=brush
early_exit=false
fill_shape=false

• save_dir is where swappshots will be saved, can contain env variables, when it does not exist, swappy attempts to create it first, but does not abort if directory creation fails
• save_filename_format: is the filename template, if it contains a date format, this will be parsed into a timestamp. Format is detailed in strftime(3). If this date format is missing, filename will have no timestamp
• show_panel is used to toggle the paint panel on or off upon startup
• line_size is the default line size (must be between 1 and 50)
• text_size is the default text size (must be between 10 and 50)
• text_font is the font used to render text, its format is pango friendly
• paint_mode is the mode activated at application start (must be one of: brush|text|rectangle|ellipse|arrow|blur, matching is case-insensitive)
• early_exit is used to make the application exit after saving the picture or copying it to the clipboard
• fill_shape is used to toggle shape filling (for the rectangle and ellipsis tools) on or off upon startup

• Ctrl+b: Toggle Paint Panel

• b: Switch to Brush
• t: Switch to Text
• r: Switch to Rectangle
• o: Switch to Ellipse
• a: Switch to Arrow
• d: Switch to Blur (d stands for droplet)

• R: Use Red Color
• G: Use Green Color
• B: Use Blue Color
• C: Use Custom Color
• Minus: Reduce Stroke Size
• Plus: Increase Stroke Size
• Equal: Reset Stroke Size
• f: Toggle Shape Filling
• k: Clear Paints (cannot be undone)

• Ctrl: Center Shape (Rectangle & Ellipse) based on draw start

• Ctrl+z: Undo
• Ctrl+Shift+z or Ctrl+y: Redo
• Ctrl+s: Save to file (see man page)
• Ctrl