A cross-platform multi-screen shot module in pure python using ctypes

Very basic, it will grab one screen shot by monitor or a screen shot of all monitors and save it to an optimised PNG file, Python 2.7/3.3 compatible.

So, while you can pip install mss, you may just drop it in your project and forget about it.

MSS stands for Multi-Screen Shot.

It’s under zlib licence.

Instance the good class

You can determine automatically which class to use:

from platform import system
from mss import *

systems = {
    'Darwin' : MSSMac,
    'Linux'  : MSSLinux,
    'Windows': MSSWindows
}
try:
    MSS = systems[system()]
except KeyError:
    err = 'System "{0}" not implemented.'.format(system())
    raise NotImplementedError(err)

Or simply import the good one:

from mss import MSSLinux as MSS

init(debug=False)

When initalising an instance of MSS, you can enable debug output:

mss = MSS(debug=True)

save(output=’mss’, oneshot=False)

For each monitor, grab a screen shot and save it to a file.

Parameters:

output - string - the output filename without extension
oneshot - boolean - grab only one screen shot of all monitors

This is a generator which returns created files:

'output-1.png',
'output-2.png',
...,
'output-NN.png'
or
'output-full.png'

Example

Then, it is quite simple:

try:
    mss = MSS()

    # One screen shot per monitor
    for filename in mss.save():
        print('File "{0}" created.'.format(filename))

    # A shot to grab them all :)
    for filename in mss.save(oneshot=True):
        print('File "{0}" created.'.format(filename))
except Exception as ex:
    print(ex)
    raise

Bonus

Just for fun … Show us your screen shot with all monitors in one file, we will update the gallery.

Link to the galley: https://tiger-222.fr/tout/python-mss/galerie/

Metadata

Release files for mss 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mss 0.0.3
File	Size	Uploaded
mss-0.0.3.tar.gz	8.9 kB	Oct 30, 2013	Details

Release files / mss-0.0.3.tar.gz

Download URL	mss-0.0.3.tar.gz
Size	8.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`f20a95f8fe12b2c7e42071fab67122cb9cf9316c8aeca3f4367eb2fc83ff1791`
BLAKE2b-256 checksum How to use checksums	`c43b0d42ed31791fa9dac5367ec4247c9b290196a9482950ffea7c99cd80804c`
Upload date	Oct 30, 2013
Uploaded using Trusted Publishing? What is trusted publishing?	No