Welcome to Python MSS’s documentation!

from mss import mss

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

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

  • Python 2 & 3 and PEP 8 compliant, no dependency;
  • 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 softwares which require fast and plateforme optimized methods to grab screenshots;
  • get the source code on GitHub;
  • need some help? Use the tag python-mss on StackOverflow;
  • learn with a bunch of examples;
  • you can report a bug;
  • MSS stands for Multiple ScreenShots;

Indices and tables