https://github.com/ws-kj/xsnip

a minimal and convenient screenshot utility for X11
https://github.com/ws-kj/xsnip

c clipboard screenshot x11

Last synced: 6 days ago
JSON representation

a minimal and convenient screenshot utility for X11

• Host: GitHub
• URL: https://github.com/ws-kj/xsnip
• Owner: ws-kj
• License: gpl-3.0
• Created: 2021-12-24T05:28:02.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2022-08-01T15:11:11.000Z (over 2 years ago)
• Last Synced: 2023-03-12T02:23:16.056Z (almost 2 years ago)
• Topics: c, clipboard, screenshot, x11
• Language: C
• Homepage:
• Size: 293 KB
• Stars: 27
• Watchers: 4
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

        
# xsnip - a minimal and convenient screenshot utility for X11

Most screenshot utilities compatible with X are clumsy, use bloated toolkits, and often do not support selection regions or the clipboard. 

xsnip seeks to streamline the screenshot process in a number of ways. 

xsnip is compatible with any window manager, has no graphical interface, has automatic clipboard support, and is entirely based on selection regions over specific windows. 

While most screenshot tools require either a cli flag or a button to save images to the clipboard, xsnip selections made with the left mouse button will automatically be copied, saving time and input.

## Installation

xsnip requires xclip and libpng, both of which can usually be installed via your system package manager.

With dependencies installed and repo cloned:

`make`

`make install` 

## Usage

Click and drag anywhere on the screen to make a selection, or screenshot a window by clicking on it.

A selection made with the left mouse button will be automatically copied to the clipboard.

A selection made with the right mouse button will be saved under ~/Pictures by default.

You can exit the program without taking a screenshot with the esecape key.

It is recommended that you assign xsnip to a keybind in your window manager for convenient use.

## Configuration

The saved screenshot directory, poll rate, quit key, and cursor glyph can all be changed from their default values by editing the corresponding macros at the top of `xsnip.c` and recompiling.

If you experience strange behavior when the program is running, such as a black or blurry screen, run xsnip in opaque mode with the flag `-o`, or recompile with the `OPAQUE` macro set to `true` to set it as the default. When the default mode is opaque, you can run in transparent mode with the `-t` flag. 

You should compile in opaque mode if your window manager/compositor does not support transparency.