Welcome to Python MSS’s documentation!

PyPI Version PyPI Status PyPI Python Versions Github Build Status GitHub License

Patreon

from mss import mss

# The simplest use, save a screenshot 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.9+, PEP 8 compliant, no dependency, thread-safe;

  • very basic, it will grab one screenshot by monitor or a screenshot 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 screenshots (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 Stack Overflow ;

  • MSS stands for Multiple ScreenShots;

Indices and tables