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.

Files for escrotum, version 1.0.1
Filename, size File type Python version Upload date Hashes
Filename, size escrotum-1.0.1-py3-none-any.whl (23.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size escrotum-1.0.1.tar.gz (10.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page