Minimal screenshot annotation tool

Last update: Dec 26, 2022

Related tags

Overview

pinsel

What

This is a program that helps with quick small annotations in screenshots made with maim or something similar. Everything is in progress currently.

Usage

You can open a file by passing it as the first argument: pinsel path/to/file.png or by piping into the program. That's why pinsel file.png and cat file.png | pinsel behave the same. If there is both an argument and an image being piped into the program, piping will be prefered.

You can pre-define the destination of a saved file with the -o flag. The save shortcuts will then just save the image to the destination saving you from the tiring file dialog (especially in day-to-day usage).

An example usage for screenshot taking may look like the following:

maim -s | pinsel -o $HOME/$(date).png | xclip -selection clipboard -t image/png

First you select your screenshot through maim like you are used to. The result gets piped into pinsel where you can do annoatations and where you are free to save the image to ~/$(date).png or not. If you don't want to annotate your image then you can still decide on whether to save it or not (which may add one key press in total to that workflow in the "worst case"). The end result gets piped to your clipboard for further usage.

Flags

-o, --output predefines the save-destination
-f, --format defines the image format of the stdout output
--ontop puts the window above all others on startup
--maximize maximizes the window on startup
-h, --help, -v, --version wip

Shortcuts

Open the shortcut dialog to look them up 👍

Installation

git clone https://github.com/Nooo37/pinsel.git
cd pinsel
sudo make install # will put the binary in /usr/local/bin

Video

TODO

allow for all font faces
add --help text, man page
allow for other formats than png
make text actually draggable when the dialog is open
add a titlebar to the text dialog
release

my first C project - don't be harsh

xsnip - a minimal and convenient screenshot utility for X11

xsnip - a minimal and convenient screenshot utility for X11 Most screenshot utilities compatible with X are clumsy, use bloated toolkits, and often do

25 Sep 8, 2022

Greenshot - a free screenshot tool optimized for productivity

Greenshot - a free screenshot tool optimized for productivity Welcome to the source repository for Greenshot What is Greenshot? Greenshot is a light-w

3.1k Dec 30, 2022

Xournal++ is a handwriting notetaking software with PDF annotation support. Written in C++ with GTK3, supporting Linux (e.g. Ubuntu, Debian, Arch, SUSE), macOS and Windows 10. Supports pen input from devices such as Wacom Tablets.

Xournal++ is a hand note taking software written in C++ with the target of flexibility, functionality and speed. Stroke recognizer and other parts are based on Xournal Code

7.9k Jan 7, 2023

Xournal++ is a handwriting notetaking software with PDF annotation support

Xournal++ is a handwriting notetaking software with PDF annotation support. Written in C++ with GTK3, supporting Linux (e.g. Ubuntu, Debian, Arch, SUSE), macOS and Windows 10. Supports pen input from devices such as Wacom Tablets.

7.9k Jan 4, 2023

Flameshot - Powerful yet simple to use screenshot software.

19.8k Dec 31, 2022

Make screenshot every few minutes to make your small history!

Screenlapse Fun CPP application (which isn't well-made, can be optimized) that automatically make screenshots of your screen every few minutes and sto

3 Aug 18, 2021

Minimal Linux Live (MLL) is a tiny educational Linux distribution, which is designed to be built from scratch by using a collection of automated shell scripts. Minimal Linux Live offers a core environment with just the Linux kernel, GNU C library, and Busybox userland utilities.

Minimal Linux Live (MLL) is a tiny educational Linux distribution, which is designed to be built from scratch by using a collection of automated shell scripts. Minimal Linux Live offers a core environment with just the Linux kernel, GNU C library, and Busybox userland utilities.

1.3k Jan 8, 2023

Minimal tool for measuring cost of mode switch

CPU mode switch statistics The mode-switch-stat tool measures the cost of CPU mode switch, the round trip between user and kernel mode. At present, th

12 Feb 22, 2022

Colibri core is an NLP tool as well as a C++ and Python library for working with basic linguistic constructions such as n-grams and skipgrams (i.e patterns with one or more gaps, either of fixed or dynamic size) in a quick and memory-efficient way. At the core is the tool ``colibri-patternmodeller`` whi ch allows you to build, view, manipulate and query pattern models.

Colibri Core by Maarten van Gompel, [email protected], Radboud University Nijmegen Licensed under GPLv3 (See http://www.gnu.org/licenses/gpl-3.0.html

122 Nov 17, 2022

Colibri core is an NLP tool as well as a C++ and Python library for working with basic linguistic constructions such as n-grams and skipgrams (i.e patterns with one or more gaps, either of fixed or dynamic size) in a quick and memory-efficient way. At the core is the tool ``colibri-patternmodeller`` whi ch allows you to build, view, manipulate and query pattern models.

Colibri Core by Maarten van Gompel, [email protected], Radboud University Nijmegen Licensed under GPLv3 (See http://www.gnu.org/licenses/gpl-3.0.html

122 Nov 17, 2022

Comments

Misc Usability Changes
I'm thinking

^z to undo, ^Z / ^r to redo

ctrl-alt mousewheel to increase/decrease brush size (ala gimp)

clicking should make a dot, instead of having to move at least 1px for it to register

shift-clicking should draw a straight line from the last draw position (ala gimp)

some (if not all) of these are probably complicated though.

Either way, nice project, gimp starts wayyy too slowly for edits like this.
opened by 6gk 4
memory leak when drawing

whenever I draw (ie hold left mouse and move it) the memory usage goes up quite fast, but doesn't go down.

I think this may have to do with the undo logic (btw you should add ^z support), even though it still happens if I don't let go, and the memory usage doesn't go down if I "reset" the undo history (undo, make new change). I'm assuming that it saves the previous image instead of just the changes.

opened by 6gk 2
Arguments

Didn't try out the is_maximized and is_on_top options so you should probably test them. --help (-h) and --version (-v) are automatically handled by argp using the corresponding metadata in the top section of pinsel.c.

opened by Baseng0815 1
Updated shell.nix and Makefile

The nix shell file needed lua, and for some reason I couldn't build on NixOS, which lead to the Makefile code addition.

You should try building on your system first to see if it works.

Related Bug Thread

opened by JavaCafe01 0

Minimal screenshot annotation tool

Related tags

Overview

pinsel

What

Usage

Flags

Shortcuts

Installation

Video

TODO

You might also like...

xsnip - a minimal and convenient screenshot utility for X11

Greenshot - a free screenshot tool optimized for productivity

Xournal++ is a handwriting notetaking software with PDF annotation support. Written in C++ with GTK3, supporting Linux (e.g. Ubuntu, Debian, Arch, SUSE), macOS and Windows 10. Supports pen input from devices such as Wacom Tablets.

Xournal++ is a handwriting notetaking software with PDF annotation support

Flameshot - Powerful yet simple to use screenshot software.

Make screenshot every few minutes to make your small history!

Minimal Linux Live (MLL) is a tiny educational Linux distribution, which is designed to be built from scratch by using a collection of automated shell scripts. Minimal Linux Live offers a core environment with just the Linux kernel, GNU C library, and Busybox userland utilities.

Minimal tool for measuring cost of mode switch

Minimal unit testing framework for C

Dear ImGui: Bloat-free Graphical User interface for C++ with minimal dependencies

Minimal Huffman coder/decoder

Minimal A* implementation in C. No dynamic memory allocation.

Minimal A* implementation in C. No dynamic memory allocation.

cherry: A Minimal HTTP Server

minimal POSIX compliant sleep

The minimal opencv for Android, iOS and ARM Linux

A single header C++ library for parsing command line arguments and options with minimal amount of code

Comments

Misc Usability Changes

memory leak when drawing

Arguments

Updated shell.nix and Makefile

Owner

Dear ImGui: Bloat-free Graphical User interface for C++ with minimal dependencies

[WIP] Demo of a minimal but functional Dawn-based WebGPU client and server

This is a minimal state immediate mode graphical user interface toolkit written in ANSI C and licensed under public domain

HoI4 Modding Tool That Does It All! Now with a QT based GUI, all your work wil be easier!

A powerful and fast search tool using regular expressions

Windows GUI version of the age file encryption tool (built on rage, the Rust implementation)

FLTK - Fast Light Tool Kit - a cross-platform C++ GUI toolkit for UNIX(r)/Linux(r) (X11)

Minimal screenshot annotation tool

Ksnip is a Qt-based cross-platform screenshot tool that provides many annotation features for your screenshots.

6D - Pose Annotation Tool (6D-PAT) - is a tool that allows the user to load a set of images and also a set of 3D models and annotate where in the 2D image the 3D object ist placed.