Skip to main content

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

Project description

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

from mss import 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 -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 call SetProcessDpiAware() during import process. To prevent that, import mss first.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mss-10.2.0.tar.gz (200.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mss-10.2.0-py3-none-any.whl (67.1 kB view details)

Uploaded Python 3

File details

Details for the file mss-10.2.0.tar.gz.

File metadata

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

File hashes

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.

File details

Details for the file mss-10.2.0-py3-none-any.whl.

File metadata

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

File hashes

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.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page