Meta

• License: MIT License (MIT License)
• Author: Mickaël Schoentgen
• Maintainer: Mickaël Schoentgen
• Tags BitBlt , CGGetActiveDisplayList , CGImageGetBitsPerPixel , EnumDisplayMonitors , XGetImage , XGetWindowAttributes , XRRGetScreenResourcesCurrent , ctypes , monitor , screen , screencapture , screengrab , screenshot
• Requires: Python >=3.9
• Provides-Extra: dev , docs , tests

Classifiers

• Development Status
  • 5 - Production/Stable
• Environment
  • MacOS X
• Intended Audience
  • Developers
  • Education
  • End Users/Desktop
  • Information Technology
  • Science/Research
• License
  • OSI Approved :: MIT License
• Operating System
  • MacOS
  • Microsoft :: Windows
  • Unix
• Programming Language
  • Python
  • Python :: 3
  • Python :: 3 :: Only
  • Python :: 3.9
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Python :: 3.14
  • Python :: Implementation :: CPython
  • Python :: Implementation :: PyPy
• Topic
  • Multimedia :: Graphics :: Capture :: Screen Capture
  • Software Development :: Libraries

Python MSS

👁 PyPI version
👁 Anaconda version
👁 Tests
👁 Downloads

[!TIP] Become my boss to help me work on this awesome software, and make the world better:

👁 Patreon

frommssimport MSS

# The simplest use, save a screenshot 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.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 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 Stack Overflow;
• and there is a complete, and beautiful, documentation :)
• MSS stands for Multiple ScreenShots;

Installation

You can install it with pip:

python-mpipinstall-U--usermss

Or you can install it with Conda:

condainstall-cconda-forgepython-mss

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

Verified details

These details have been verified by PyPI

Maintainers

👁 Avatar for T2 from gravatar.com
T2

Unverified details

These details have not been verified by PyPI

Project links

• Changelog
• Documentation
• Homepage
• Released Versions
• Source
• Sponsor
• Tracker

• Download URL: mss-10.2.0.tar.gz
• Upload date: Apr 23, 2026
• Size: 200.3 kB
• Tags: Source
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/6.1.0 CPython/3.13.12

Hashes for mss-10.2.0.tar.gz

Algorithm	Hash digest
SHA256	ab271860775545e62f29d7b11f82f279ac1048f5bbdd26cfad84830208dbd393
MD5	d2aa3d1eef28c7c9bfdfe01c3b9890de
BLAKE2b-256	e55deee782a6d674f562c946ae6a026f4c595ea2b7b031f290bf9fbf60da09b5

See more details on using hashes here.

• Download URL: mss-10.2.0-py3-none-any.whl
• Upload date: Apr 23, 2026
• Size: 67.1 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/6.1.0 CPython/3.13.12

Hashes for mss-10.2.0-py3-none-any.whl

Algorithm	Hash digest
SHA256	e79f428899280e7e64e38365b5bfed683851ebea807eeaeadaf06eb8e0d67197
MD5	afe02225cc02c9bcaf94f438d0a000b6
BLAKE2b-256	f2c3313e14f245c79b4c05bd0f3a84a4813aa26fa10f8993aebd91d04c5fad3f

See more details on using hashes here.