ImageGrab Module (macOS and Windows only)

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

Note

The current version works on macOS and Windows only.

New in version 1.1.3.

• PIL.ImageGrab.grab(bbox=None, include_layered_windows=False, all_screens=False, xdisplay=None)
• Take a snapshot of the screen. The pixels inside the bounding box arereturned as an “RGB” image on Windows or “RGBA” on macOS.If the bounding box is omitted, the entire screen is copied.

New in version 1.1.3: (Windows), 3.0.0 (macOS), 7.1.0 (Linux (X11))

Parameters:

• bbox – What region to copy. Default is the entire screen.Note that on Windows OS, the top-left point may be negative if all_screens=True is used.
• include_layered_windows –
  Includes layered windows. Windows OS only.

New in version 6.1.0.

• all_screens –
  Capture all monitors. Windows OS only.

New in version 6.2.0.

• xdisplay –
  • X11 Display address. Pass None to grab the default system screen.
  • Pass "" to grab the default X11 screen on Windows or macOS.

New in version 7.1.0.

Returns:
An image

• PIL.ImageGrab.grabclipboard()
• Take a snapshot of the clipboard image, if any.

New in version 1.1.4: (Windows), 3.3.0 (macOS)

Returns:On Windows, 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.
On Mac, an image,or None if the clipboard does not contain image data.