1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121
|

# scrot (SCReenshOT)
#### scrot - command line screen capture utility
## What is scrot? ##
scrot is a simple command line screen capture utility, it uses imlib2 to grab
and save images.
scrot has many useful features:
- Support for multiple image formats: JPG, PNG, GIF, and others supported by Imlib2.
- The screenshot's quality is configurable.
- It is possible to capture a specific window or a rectangular area on the
screen.
Because scrot is a command line utility, it can easily be scripted and put to
novel uses. For instance, scrot can be used to monitor an X server in absence.
scrot is free software under the [MIT-feh](COPYING) license.
## Help this project ##
scrot needs your help. **If you are a programmer** and want to help a nice
project, this is your opportunity.
The original scrot went unmaintained; the source of the last version, 0.8, was
[imported from Debian](https://snapshot.debian.org/package/scrot/). After,
patches from Debian and elsewhere were applied to create the 0.9 release. The
details of our releases are registered in the [ChangeLog](ChangeLog) file.
Now, scrot is maintained by volunteers under [Resurrecting Open Source Projects](https://github.com/resurrecting-open-source-projects).
If you are interested in helping scrot, read the [CONTRIBUTING.md](CONTRIBUTING.md) file.
## Installing ##
scrot is available in the official repository of many linux/BSD distributions.
It is recommended to use the system package manager for installing scrot.
For example, Debian users can run the following command to install scrot:
```console
$ sudo apt install scrot
```
A list of repositories that package scrot is
[available here](https://repology.org/project/scrot/versions).
If your distribution does not package scrot, you may also build scrot from
source by following the build instructions below.
## Building ##
This section describes the steps to build and install scrot.
### Dependencies ###
scrot requires a few projects and libraries:
- [autoconf](https://www.gnu.org/software/autoconf/autoconf.html) (build time only)
- [autoconf-archive](https://www.gnu.org/software/autoconf-archive/) (build time only)
- A pkg-config implementation [(e.g. pkgconf)](https://github.com/pkgconf/pkgconf) (build time only)
- [imlib2](https://sourceforge.net/projects/enlightenment/files/imlib2-src/)
(must be built with X support)
- [libbsd](https://libbsd.freedesktop.org/wiki/) (only needed if `<err.h>` is missing)
- An X11 implementation [(e.g. X.Org)](https://www.x.org/wiki/)
- libXcomposite [(can be found in X.Org)](https://gitlab.freedesktop.org/xorg/lib/libxcomposite)
- libXfixes [(can be found in X.Org)](https://gitlab.freedesktop.org/xorg/lib/libxfixes)
- libXrandr [(can be found in X.Org)](https://gitlab.freedesktop.org/xorg/lib/libxrandr)
The [deps.pc](./deps.pc) file documents minimum version requirement for some of
the libraries.
### Generic installation instructions ###
If you are building from a git checkout, or if you have applied additional
patches to a tarball release, run:
```console
$ ./autogen.sh
```
TIP: if the source code does not have a _configure_ file, you need to run
`./autogen.sh`.
If you have a tarball release, or after running the command above on a git
checkout or a patched tarball, run:
```console
$ ./configure && make
```
To install the compiled result, run as root:
```console
# make install
```
Or, as a regular user:
```console
$ sudo make install
```
Cleaning up the build is also simple:
```console
$ make clean
```
To vanish the source code, removing all pre-built files, including _configure_,
run:
```console
$ make distclean
```
You can return to a pristine source tree before running `./configure`:
```console
$ ./autogen.sh clean
```
Bash and Zsh completion scripts are available in [etc/](./etc).
## Author ##
scrot was originally developed by Tom Gilbert.
Currently, source code is maintained by volunteers. Newer versions are
available at https://github.com/resurrecting-open-source-projects/scrot
|