Skip to main content

Linux screen capture and screen recording program inspired by scrot.

Why?

Because scrot has glitches when selection is used in refreshing windows

Features

  • fullscreen screenshots

  • screen recording

  • partial(selection) screenshots

  • window screenshot(click to select)

  • screenshot by xid

  • store the image to the clipboard

usage: escrotum [-h] [-v] [-s] [-x XID] [-d DELAY]
                [--selection-delay SELECTION_DELAY] [-c] [-C] [-e COMMAND]
                [-r]
                [FILENAME]

positional arguments:
  FILENAME              image filename, default is
                        %Y-%m-%d-%H%M%S_$wx$h_escrotum.png

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         output version information and exit
  -s, --select          interactively choose a window or rectangle with the
                        mouse, cancels with Esc or Right Click
  -x XID, --xid XID     take a screenshot of the xid window
  -d DELAY, --delay DELAY
                        wait DELAY seconds before taking a shot
  --selection-delay SELECTION_DELAY
                        delay in milliseconds between selection/screenshot
  -c, --countdown       show a countdown before taking the shot (requires
                        delay)
  -C, --clipboard       store the image on the clipboard
  -e COMMAND, --exec COMMAND
                        run the command after the image is taken
  -r, --record          screen recording. Alt+Ctrl+s to stop the recording

  SPECIAL STRINGS
  Both the --exec and filename parameters can take format specifiers
  that are expanded by escrotum when encountered.

  There are two types of format specifier. Characters preceded by a '%'
  are interpreted by strftime(2). See man strftime for examples.
  These options may be used to refer to the current date and time.

  The second kind are internal to escrotum and are prefixed by '$'
  The following specifiers are recognised:
    $f image path/filename (ignored when used in the filename)
    $w image width
    $h image height
  Example:
    escrotum '%Y-%m-%d-%H%M%S_$wx$h_escrotum.png'
    Creates a file called something like 2013-06-17-082335_263x738_escrotum.png

  EXIT STATUS CODES
  1 can't get the window by xid
  2 invalid pixbuf
  3 can't save the image
  4 user canceled selection
  5 can't grab the mouse
  6 error with ffmpeg

Install

  • on archlinux, install with your favorite aur manager, ie. yay -S escrotum-git

  • with pip, pip install escrotum

Release files for escrotum 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for escrotum 1.0.1
File Size Uploaded
escrotum-1.0.1.tar.gz 10.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for escrotum 1.0.1
File Interpreter ABI Platform
escrotum-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 33.7 kB

Release files / escrotum-1.0.1.tar.gz

Download URL escrotum-1.0.1.tar.gz
Size 10.4 kB
Tags Source
SHA-256 checksum
How to use checksums
73bf0d56cb63a540b22960e86524fa905620351236ecc82a719be55a0a775f5a
BLAKE2b-256 checksum
How to use checksums
c93798551fb09f323a16a6acc79e3ad13f8e3449b72522ec28a39cf4baccd2ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.8.1

Release files / escrotum-1.0.1-py3-none-any.whl

Download URL escrotum-1.0.1-py3-none-any.whl
Size 23.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
50e1ef1c901d87ce96b5951decdcc2735393c5995a1af18e237c48b297f9bcbf
BLAKE2b-256 checksum
How to use checksums
f578d59e6072a523115af42bbb8265eca735c52ff5a95b2ef6a28880156e0f4c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.8.1

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files

1.0.0

2 release files

0.2.1

1 release file

0.2.0

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page