Skip to main content

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

Project description

Python MSS

PyPI version Anaconda version Tests workflow Downloads

from mss import mss

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

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

  • Python 3.8+, 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;


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
twine check dist/*
twine upload dist/*

Download files

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

Source Distribution

mss-9.0.1.tar.gz (87.5 kB view hashes)

Uploaded Source

Built Distribution

mss-9.0.1-py3-none-any.whl (22.2 kB view hashes)

Uploaded Python 3

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