crabture 0.2.2

Standalone Linux screenshot tool — no external dependencies required. Supports X11 and Wayland.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

# crabture

Standalone Linux screenshot tool written in Rust. No external dependencies required — works on both X11 and Wayland.

[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](LICENSE)
[![CI](https://github.com/piny4man/crabture/actions/workflows/ci.yml/badge.svg)](https://github.com/piny4man/crabture/actions/workflows/ci.yml)
[![crates.io](https://img.shields.io/crates/v/crabture.svg)](https://crates.io/crates/crabture)

## Features

- **Full-screen capture** — instant screenshot of primary or any monitor
- **Region capture** — specify exact coordinates (`x,y,WxH`)
- **Interactive area selection** — click and drag with visual overlay feedback
- **Interactive TUI** — guided menu for timing, target, and save method
- **Multi-monitor support** — list and capture any connected monitor
- **Clipboard support** — copy screenshots directly to the clipboard
- **Delayed capture** — configurable countdown (5/10/20/30/60 seconds)
- **Desktop notifications** — status feedback via system notifications
- **Multiple formats** — save as PNG or JPG
- **XDG-compliant** — respects `XDG_SCREENSHOTS_DIR`, falls back to `~/Pictures`

## Installation

### From crates.io

```sh
cargo install crabture
```

### From source

```sh
git clone https://github.com/piny4man/crabture.git
cd crabture
cargo build --release
# binary at target/release/crabture
```

### Arch Linux (AUR)

```sh
# Using an AUR helper
paru -S crabture-git
```

### Build dependencies

These are only needed when **building from source**. Prebuilt binaries from the
[releases page](https://github.com/piny4man/crabture/releases) have no extra
runtime dependencies.

#### Debian / Ubuntu

```sh
sudo apt-get install -y \
  libclang-dev libwayland-dev libpipewire-0.3-dev libegl-dev \
  libgbm-dev libdrm-dev libxcb1-dev libxcb-shm0-dev libxcb-randr0-dev
```

#### Arch Linux

```sh
sudo pacman -S clang libxcb wayland pipewire
```

## Usage

```sh
# Interactive TUI (default)
crabture

# Instant full-screen screenshot
crabture --instant

# Capture a specific monitor (1-based index)
crabture --monitor 2

# Interactive area selection
crabture --select

# Capture a region by coordinates
crabture --region 100,200,800x600

# Copy to clipboard instead of saving
crabture --instant --copy

# Save as JPG to a specific directory
crabture --instant --format jpg ~/screenshots

# List available monitors
crabture --list-monitors
```

## License

GPL-3.0 — see [LICENSE](LICENSE) for details.