Skip to content

kakoc/birdy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ed8960e · Nov 22, 2024

History

41 Commits
Sep 7, 2023
Sep 25, 2023
Sep 4, 2024
Feb 18, 2024
Feb 18, 2024
Sep 6, 2023
Apr 13, 2024
Apr 13, 2024
Sep 25, 2023
Sep 6, 2023
Sep 6, 2023
Apr 13, 2024
Oct 30, 2023
Oct 30, 2023

Repository files navigation

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')