by BoboTiG

BoboTiG /python-mss

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

513 Stars 46 Forks Last release: 3 months ago (v6.0.0) MIT License 631 Commits 31 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

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.