/birdy

Screenshot tool

Primary LanguageRustOtherNOASSERTION

github crates.io docs.rs build status

Screenshot tool for Linux.
Supports both X11 and Wayland.

People told me that it also works on Windows and partially on MacOS.
Since I'm not using neither MacOS or Windows at all there are no any guarantees related to these platforms.
If you want to add a support for MacOS or Windows - PRs are welcome.

image info

Installation

cargo install birdy --locked

Usage

Quic start

Currently it can be run only through "birdy" executable(from terminal, app launcher(e.g. rofi), bound to a hotkey):

  # makes a screenshot of the selected area and saves it into clipboard
  birdy

  # makes a screenshot of the selected area with a custom drawn items color, from screen with id=1 and saves it into $HOME/Pictures
  birdy -b 0,255,0,255 -s 1 -d $HOME/Pictures

  # e.g. sway
  sway bindsym $mod+Shift+p exec birdy

Help

birdy --help

Hotkeys while running (see lower for cli args):

Enter - take a screenshot of selected area, save to a clipboard and exit

f - take a screenshot where selected area is focused, save to a clipboard and exit

a - draw an arrow

z - draw a filled arrow

l - draw a line

r - draw a rectangular border

p - draw a filled rectangle

b - draw a blurred rectangle

t - draw a text

Tab - toggle latest drawn shape between filled/not filled states

Esc - exit

Usage: birdy [OPTIONS]

Options:
  -b, --border-color <BORDER_COLOR>
          

  -s, --screen <SCREEN>
          

  -d, --dir <DIR>
          save directory

  -c, --clipboard
          save to clipboard instead of path

  -h, --help
          Print help (see a summary with '-h')