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 workflow 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.1.0.tar.gz (84.2 kB view details)

Uploaded Source

Built Distribution

mss-10.1.0-py3-none-any.whl (24.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for mss-10.1.0.tar.gz
Algorithm Hash digest
SHA256 7182baf7ee16ca569e2804028b6ab9bcbf6be5c46fc2880840f33b513b9cb4f8
MD5 a2a131d0bb2153d0728c5c63a406a5aa
BLAKE2b-256 40ca49b67437a8c46d9732c9c274d7b1fc0c181cfe290d699a0c5e94701dfe79

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for mss-10.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9179c110cadfef5dc6dc4a041a0cd161c74c379218648e6640b48c6b5cfe8918
MD5 041ba7e3ce97178209cb6b7fa99c523c
BLAKE2b-256 23281e3e5cd1d677cca68b26166f704f72e35b1e8b6d5076d8ebeebc4e40a649

See more details on using hashes here.

Supported by

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