mss · PyPI

from mss import mss

# The simplest use, save a screen shot of the 1st monitor
with mss() as sct:
    sct.shot()

An ultra fast cross-platform multiple screenshots module in pure python using ctypes.

Python 3.8+ and PEP8 compliant, no dependency, thread-safe;
very basic, it will grab one screen shot by monitor or a screen shot of all monitors and save it to a PNG file;
but you can use PIL and benefit from all its formats (or add yours directly);
integrate well with Numpy and OpenCV;
it could be easily embedded into games and other software which require fast and platform optimized methods to grab screen shots (like AI, Computer Vision);
get the source code on GitHub;
learn with a bunch of examples;
you can report a bug;
need some help? Use the tag python-mss on StackOverflow;
and there is a complete, and beautiful, documentation :)
MSS stands for Multiple Screen Shots;

Installation

You can install it with pip:

python -m pip install -U --user mss

Or you can install it with conda:

conda install -c conda-forge python-mss

For the maintainers, here are commands to upload a new release:

rm -rf build dist
python -m build --sdist --wheel
twine check dist/*
twine upload dist/*

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

Source distribution for mss 8.0.1
File	Size	Uploaded
mss-8.0.1.tar.gz	70.3 kB	Apr 9, 2023	Details

Table of built distributions (wheels) for mss 8.0.1
File	Interpreter	ABI	Platform	Reset
mss-8.0.1-py3-none-any.whl 79.6 kB Apr 9, 2023	Python 3	none	any	Details

Total release size: 149.9 kB

Download URL	mss-8.0.1.tar.gz
Size	70.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`df10e01c1801e5552271f9baef4f083775cacbfa6f9c3eae52382dfaf90f471e`
BLAKE2b-256 checksum How to use checksums	`8ecd854ef091ef0e66d429baf38a365e3445800994d0c1ea56089b22f06128ea`
Upload date	Apr 9, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.2`

Download URL	mss-8.0.1-py3-none-any.whl
Size	79.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e9dbcf8abfb46364f8bf4e2d31e65a87a72f1ac8ed3bcb31649566c8e741d455`
BLAKE2b-256 checksum How to use checksums	`d0889189108080ccb00161cf1e82eccc1c5e899380b70b465eaf9b7ee19dbbae`
Upload date	Apr 9, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.2`