Awesome Open Source
Awesome Open Source

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:

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 StackOverflow <>_;
  • 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

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (55,539
cli (1,842
macos (1,811
windows (1,516
cross-platform (707
monitor (171
screenshot (160
python-library (156
efficiency (27
gnu-linux (23