Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/matiasOliva64/dotfiles-Hyprland-fedora/llms.txt

Use this file to discover all available pages before exploring further.

This setup uses grim to capture pixels from the Wayland compositor and pipes the result directly into swappy, an annotation tool that lets you draw, add text, and save the final image. No intermediary files are written to disk until you explicitly save from swappy.

​
Required packages

Both tools are included in the main installation command from the README: 
sudo dnf install grim swappy
slurp is also required for region selection — it provides the interactive crosshair cursor that lets you draw a capture rectangle.

​
Keybindings

The bindings are defined in hypr/hyprland.conf: 
bind = , Print, exec, grim -g "$(slurp)" - | swappy -f -
bind = SHIFT, Print, exec, grim - | swappy -f -
ShortcutAction
PrintDraw a region with your cursor, then open it in swappy
Shift + PrintCapture the entire screen and open it in swappy

​
Set up the screenshot directory

Swappy needs a directory to exist before it can save files. Create one (or both) of the following depending on your system locale: 
mkdir -p ~/Imágenes/Screenshots
mkdir -p ~/Pictures/Screenshots
The Spanish path (~/Imágenes/Screenshots) is the default for Spanish-locale Fedora installs; the English path (~/Pictures/Screenshots) is for English locales. You only need to create the one that matches your home folder layout.

​
How it works

Region screenshot (Print): 
grim -g "$(slurp)" - | swappy -f -
  1. slurp launches an interactive selection overlay — click and drag to define the region.
  2. grim -g "$(slurp)" captures only that region and writes raw image data to stdout (-).
  3. swappy -f - reads from stdin (-f -) and opens the annotation window.
Full-screen screenshot (Shift + Print): 
grim - | swappy -f -
  1. grim - captures the entire screen and writes to stdout.
  2. swappy -f - receives it and opens the annotation window.
Swappy opens an editor window after every capture. You can draw shapes, add text labels, highlight areas, or just press Save to write the image to disk as-is.
You can change the default save directory by editing ~/.config/swappy/config. Set save_dir to any path you prefer, for example:
[Default]
save_dir=$HOME/Pictures/Screenshots
save_filename_format=swappy-%Y%m%d-%H%M%S.png

Build docs developers (and LLMs) love

Get started for freeTalk to us