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.0
File	Size	Uploaded
mss-8.0.0.tar.gz	70.0 kB	Apr 9, 2023	Details

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

Total release size: 149.5 kB

Download URL	mss-8.0.0.tar.gz
Size	70.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`17c0fc0ea13f81703f6027e439ee1aef9db46b44f3767f6dd6dd0f4b61ef8737`
BLAKE2b-256 checksum How to use checksums	`b10918677dbc0b793a4d09e9057204b9dc6e791e41c16af7addb4f2f9a287e4e`
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.0-py3-none-any.whl
Size	79.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b6d774af728d79761dd28b666aa5a78f3efb12c12d546c3e4388dc490c547bf3`
BLAKE2b-256 checksum How to use checksums	`9b76f5ea57792fa391041e43ea0a7b3297381430ba247d4ceac4989cdd0900bc`
Upload date	Apr 9, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.2`