[
](https://github.com/kakoc/birdy)
[
](https://crates.io/crates/birdy)
[
](https://docs.rs/birdy/latest/birdy)
[
](https://github.com/kakoc/birdy/actions/workflows/rust.yml)
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.
## Installation
```bash
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
-s, --screen
-d, --dir
save directory
-c, --clipboard
save to clipboard instead of path
-h, --help
Print help (see a summary with '-h')
```