ahmadalwa / screenpen Goto Github PK

Multiplatform screen annotation software that allows drawing directly on the screen.

Screen annotation software which allows drawing directly on the screen. It is an open source and multiplatform (all systems that support Python) alternative to tools such as Epic Pen. Supported shapes:

• line,
• rectangle,
• chart (using matplotlib).

The behavior of the program depends on the Window System you use:

• if the system supports "live transparency then a transparent background is used (you can see a video playing in the background),
• if not then the screenshot is taken, and the user draws on the captured image (you see a static image of the screen),
• sometimes your WM may be detected as not supporting "live transparency". In that case try running with -t parameter to force it._

Note: The app is created ad-hoc only for my use case. It may contain bugs...

Tu run the program you need to have Python installed and execute following:

pip install screenpen
screenpen                # or python -m screenpen

NOTE: Your WM may be detected as not supporting "live transparency". In that case try running with -t parameter:

screenpen -t

• Left mouse button - drawing.
• Right mouse button - quit.
• Keyboard shortcuts:
  • Ctrl+Z - undo,
  • Ctrl+Y - redo,
  • hold Shift - change mouse cursor icon to arrrow.

There are a few configuration options that can be set using config file:

• icon_size - size of the icons (default: 50)
• hidden_menus - to hide menus on start (default: False)

The config should look like below:

[screenpen]
; Possible values for areas: topToolBarArea, bottomToolBarArea, leftToolBarArea, rightToolBarArea
penbar_area = topToolBarArea
boardbar_area = topToolBarArea
actionbar_area = leftToolBarArea
hidden_menus = False
icon_size = 50

(more options will be added in the future...)

• Better Matplotlib charts support.
• Better wayland support.
• Extended configuration.

Screenpen (from 0.2 version) is compatible with PyQt5 and PyQt6, nevertheless the PyQt5 is currently in the requirements and recommended. It is possible to run it using PyQt6 by running:

pip install matplotlib>=3.2 numpy>=1.8 PyQt6
pip install screenpen --no-deps

Screenpen works in some Wayland compositors, but it is not perfect. There are issues with windows positioning and transparency. In case the window opens on wrong monitor (which I noticed on Sway WM) you can move it using Win+Shift+Arrows (or Alt+Shift+Arrows) shortcuts to a desired monitor. I have no plans to fix it in near future, but I will accept PRs.