Skip to main content

Minimalist screenshot capture and screen recording program inspired by scrot.

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

escrotum-1.0.1.tar.gz (10.4 kB view details)

Uploaded Source

Built Distribution

escrotum-1.0.1-py3-none-any.whl (23.3 kB view details)

Uploaded Python 3

File details

Details for the file escrotum-1.0.1.tar.gz.

File metadata

  • Download URL: escrotum-1.0.1.tar.gz
  • Upload date:
  • Size: 10.4 kB
  • Tags: Source
  • Uploaded using 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

File hashes

Hashes for escrotum-1.0.1.tar.gz
Algorithm Hash digest
SHA256 73bf0d56cb63a540b22960e86524fa905620351236ecc82a719be55a0a775f5a
MD5 e49bb1023990acb77ac6d67b7f7a9510
BLAKE2b-256 c93798551fb09f323a16a6acc79e3ad13f8e3449b72522ec28a39cf4baccd2ee

See more details on using hashes here.

File details

Details for the file escrotum-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: escrotum-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 23.3 kB
  • Tags: Python 3
  • Uploaded using 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

File hashes

Hashes for escrotum-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 50e1ef1c901d87ce96b5951decdcc2735393c5995a1af18e237c48b297f9bcbf
MD5 184a748a416b8907b17c4434333ca1ea
BLAKE2b-256 f578d59e6072a523115af42bbb8265eca735c52ff5a95b2ef6a28880156e0f4c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page