mss · PyPI

Very basic, it will grab one screen shot by monitor or a screen shot of all monitors and save it to an optimised/progressive PNG/JPEG 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, ext=’png’, ftype=0)

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
ext - string - file format to save
ftype - int - PNG filter type (0..4 [slower])

This is a generator which returns created files:

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

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.2

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.2
File	Size	Uploaded
mss-0.0.2.tar.gz	10.3 kB	Oct 21, 2013	Details

Release files / mss-0.0.2.tar.gz

Download URL	mss-0.0.2.tar.gz
Size	10.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`6e4ea86946dc7337ba14a05567134066d98fdc8a69eb12c8d1fcb56b554a6074`
BLAKE2b-256 checksum How to use checksums	`ee32d4b0ee5f85a13188a8481f22a1fe8abc78ff611f37a9da2848ab0379730a`
Upload date	Oct 21, 2013
Uploaded using Trusted Publishing? What is trusted publishing?	No