Metadata-Version: 2.1
Name: ynot3
Version: 1.2.1
Summary: An image annotator for Xorg & Wayland using pygame
Home-page: https://github.com/fdev31/ynot3
License: GPL
Author: fdev31
Author-email: fdev31@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: pygame (>=2.4.0,<3.0.0)
Description-Content-Type: text/markdown

# ynot3

A simple image annotation program compatible with x11 and wayland.
Targetting an efficient workflow and minimal dependencies.

- can save to disk or copy to clipboard (requires `xclip` or `wl-copy`).
- copy to clipboard on exit
- unlimited undo
- antialiasing
- snapping for better alignments (override setting `SNAPPING` environment variable, defaults to 8)
- very simple user interface

Supported shapes:

- enumerated bullets
- rectangles
- arrows

## Documentation / annotation example

![](https://raw.githubusercontent.com/fdev31/ynot3/main/img/annotated.png)

1. Active tool
    - *(4)* rectangle
    - *(5)* arrow
    - *(6)* enumerated bullet
2. Active color
3. Action buttons
    - *(7)* undo (shorcut: backspace)
    - *(8)* copy to clipboard (automatic on exit)
    - *(9)* save to `/tmp/annotated.jpg` (shortcut: "s")
        - override setting the `ANNOTATED` environment variable
    - *(10)* toggle large mode (everything is magnified)
    - *(11)* clear changes (remove all annotations) (shortcut: "c")


## Installation

```
pip install ynot3
```

Or, on Archlinux:

```
yay -S ynot3
```

## Example usage

### Edit an existing image

`ynote3 ~/Images/example.jpg`

### Edit a screenshot

A simple script for Wyland using `grimshot`:

```bash
#!/bin/sh
FN="/tmp/shot.png"
grimshot save area "${FN}"
exec ynote3 "${FN}"
```

