Need help with python-mss?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

549 Stars 52 Forks MIT License 639 Commits 23 Opened issues


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

Services available


Need anything else?

Contributors list

Python MSS

.. image:: :target: .. image:: :target: .. image:: :target: .. image:: :target: .. image:: :target:

.. code-block:: python

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.5+ 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
  • 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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.