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

660 Stars 60 Forks MIT License 640 Commits 32 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.