hacksaw-1.0.4 is not a library.
hacksaw lets you select areas of your screen
(on x11)
Installation
Dependencies
Before installing, make sure you have the following libraries installed (this list is non-exhaustive):
xcb-shape
xcb-xkb
On systems with apt
, you should be able to run:
Once you have the dependencies
Simply run cargo install hacksaw
to install from crates.io.
Manual installation alternative
Clone this repo, cd
into it, and run cargo install --path .
Examples
Take a screenshot (with shotgun) of a selection/window and copy to clipboard
selection= # add hacksaw arguments inside as you wish
|
Take a screenshot of a selection/window and save to a file
selection= # add hacksaw arguments inside as you wish
Record an area of the screen with ffmpeg
#!/bin/sh
#
# record - record an area of the screen
dir=
/medias/videos/recordscurrent=
| {
IFS=+x
w=
h=
}
Also: open a terminal with the selected size and shape (on bspwm)
Features
- Guide Lines to check precise positions and line up before you start a selection
- just like the popular Guides shader for slop
- doesn't instantly quit on first keypress
- keep typing like a pro while you screenshot your memes
- (tiling wm exclusive) you can still navigate windows while in hacksaw
- select with any mouse button, not just left click!
- except right click, that's cancel
- restart selection by scrolling scrollwheel
- you can customise the colour and width of the lines
- and you can customise the width of selection and guide lines separately!
- did i mention it's written in RUST
- lightweight and fast
- not that i've actually run any performance comparisons to slop
- one of Thor's favorites
- built for the most advanced and cutting edge platform of today, X11
Stability
- Main functionality is all there and pretty solid
- You may experience bugs when invoking hacksaw while a popup is open
Usage
USAGE:
hacksaw [FLAGS] [OPTIONS]
FLAGS:
-h, --help Prints help information
-n, --no-guides Disable fighter pilot guide lines
-V, --version Prints version information
OPTIONS:
-f, --format <format>
Output format. You can use:
%x for x-coordinate,
%y for y-coordinate,
%w for width,
%h for height,
%i for selected window id,
%g as a shorthand for %wx%h+%x+%y (X geometry),
%% for a literal '%'.
Other %-codes will cause an error. [default: %g]
-g, --guide-thickness <guide-thickness> Thickness of fighter pilot guide lines [default: 1]
-c, --colour <line-colour>
Hex colour of the lines (RGB or RGBA), '#' optional [default: #7f7f7f]
-r, --remove-decorations <remove-decorations>
Number of (nested) window manager frames to try and remove [default: 0]
-s, --select-thickness <select-thickness> Thickness of selection box lines [default: 1]