ImageGrab Module (Windows-only)

The ImageGrab module can be used to copy the contents of the screen or the clipboard to a PIL image memory.

Note

The current version works on Windows only.

New in version 1.1.3.

PIL.ImageGrab.grab(bbox=None)

Take a snapshot of the screen. The pixels inside the bounding box are returned as an “RGB” image. If the bounding box is omitted, the entire screen is copied.

New in version 1.1.3.

Parameters:bbox – What region to copy. Default is the entire screen.
Returns:An image
PIL.ImageGrab.grabclipboard()

Take a snapshot of the clipboard image, if any.

New in version 1.1.4.

Returns:An image, a list of filenames, or None if the clipboard does not contain image data or filenames. Note that if a list is returned, the filenames may not represent image files.

This Page

Need help?

You can seek realtime assistance via IRC at irc://irc.freenode.net#pil. You can also post to the Image-SIG mailing list. And, of course, there's Stack Overflow.

If you've discovered a bug, you can open an issue on Github.