Repository files navigation

frommssimportmss# The simplest use, save a screenshot of the 1st monitorwithmss()assct:sct.shot()

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

• Python 3.9+, PEP8 compliant, no dependency, thread-safe;
• very basic, it will grab one screenshot by monitor or a screenshot 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 screenshots (like AI, Computer Vision);
• get thesource code on GitHub;
• learn with abunch of examples;
• you canreport a bug;
• need some help? Use the tagpython-mss onStack Overflow;
• and there is acomplete, and beautiful, documentation :)
• MSS stands for Multiple ScreenShots;

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

In case of scaling and high DPI issues for external monitors: some packages (e.g.mouseinfo /pyautogui /pyscreeze) incorrectly callSetProcessDpiAware() during import process. To prevent that, importmss first.