https://github.com/sh7ven/i3-screenshot
handy screenshot utility for i3wm.
https://github.com/sh7ven/i3-screenshot
i3-config i3wm linux screenshot-utility shell
Last synced: about 1 month ago
JSON representation
handy screenshot utility for i3wm.
- Host: GitHub
- URL: https://github.com/sh7ven/i3-screenshot
- Owner: sh7ven
- License: mit
- Created: 2025-01-14T19:14:30.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-01-14T19:39:42.000Z (3 months ago)
- Last Synced: 2025-01-24T07:13:23.829Z (3 months ago)
- Topics: i3-config, i3wm, linux, screenshot-utility, shell
- Language: Shell
- Homepage:
- Size: 6.84 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# i3scrot
simple command-line utility to take screenshots on i3wm.
can upload the screenshot to an image hosting service for easy sharing.
**PS**: it uploads to [0x0.st](https://0x0.st) by default.
## Installation
```bash
git clone https://github.com/sh7ven/i3-screenshot
cd i3-screenshot
./install.sh
```
Dependencies:
- [`maim`](https://github.com/naelstrof/maim)
- [`xclip`](https://github.com/astrand/xclip)
- [`curl`](https://github.com/curl/curl) (optional)
## Usage
```
USAGE: ./i3scrot [TYPE] [OPTIONS]
TYPE:
--window -w -- capture a particular window.
--full -f -- capture the entire screen. (:0)
--selection -s -- select a rectangle to capture.
OPTIONS:
--upload -u -- upload the image to a hosting service for easy sharing.
--service -- (TODO) image hosting service
--verbose -v -- make the curl operations verbose
```
## Examples
take a screenshot of the entire screen and upload it:
```
./i3scrot --full --upload
./i3scrot -f -u
```
take a screenshot of a selection, and be verbose:
```
./i3scrot --selection --verbose
./i3scrot -s -v
```
## With `i3`
```i3config
~/.config/i3/config
-------------------
bindsym Print exec --no-startup-id /usr/bin/i3scrot -f
bindsym Alt+Print exec --no-startup-id /usr/bin/i3scrot -w
bindsym Shift+Print exec --no-startup-id /usr/bin/i3scrot -s
```
## TODOs
- a GUI + daemon
- multi monitor
- curl flags (secret, retention time etc)
- support for different image hosting services