python screenshot
Project description
The pyscreenshot module can be used to copy the contents of the screen to a PIL or Pillow image memory. Replacement for the ImageGrab Module, which works on Windows only. For handling image memory (e.g. saving to file, converting,..) please read PIL or Pillow documentation.
- Links:
documentation: http://pyscreenshot.readthedocs.org
- Goal:
Pyscreenshot tries to allow to take screenshots without installing 3rd party libraries. It is cross-platform but useful for Linux based distributions. It is only a pure Python wrapper, a thin layer over existing back-ends. Its strategy should work on most Linux distributions: a lot of back-ends are wrapped, if at least one exists then it works, if not then one back-end should be installed. Performance and interactivity are not important for this library.
- Features:
Cross-platform wrapper
Capturing the whole desktop
Capturing an area
some back-ends are based on this discussion: http://stackoverflow.com/questions/69645/take-a-screenshot-via-a-python-script-linux
pure Python library
supported python versions: 2.6, 2.7, 3.3, 3.4, 3.5
time: 0.1s - 1.0s
- Known problems:
ImageMagick creates blackbox on some systems
PyGTK back-end does not check $DISPLAY -> not working with Xvfb
- Similar projects:
Examples
grab and show the whole screen:
#-- include('examples/showgrabfullscreen.py') --# import pyscreenshot as ImageGrab if __name__ == "__main__": # fullscreen im=ImageGrab.grab() im.show() #-#
to start the example:
python -m pyscreenshot.examples.showgrabfullscreen
grab and show the part of the screen
#-- include('examples/showgrabbox.py')--# import pyscreenshot as ImageGrab if __name__ == "__main__": # part of the screen im=ImageGrab.grab(bbox=(10,10,510,510)) # X1,Y1,X2,Y2 im.show() #-#
to start the example:
python -m pyscreenshot.examples.showgrabbox
Installation
General
Ubuntu 14.04
sudo apt-get install python-pip sudo apt-get install python-pil sudo pip install pyscreenshot # optional back-ends sudo apt-get install scrot imagemagick python-gtk2 python-qt4 python-wxgtk2.8 # optional for examples sudo pip install entrypoint2
Uninstall
# as root pip uninstall pyscreenshot
Command line interface
Back-end performance:
The performance can be checked with pyscreenshot.check.speedtest. Example: #-- sh('python -m pyscreenshot.check.speedtest --virtual-display 2>/dev/null') --# n=10 to_file: True bounding box: None ------------------------------------------------------ wx 1.3 sec ( 130 ms per call) pygtk 1 sec ( 100 ms per call) pyqt 1.1 sec ( 109 ms per call) scrot 0.71 sec ( 70 ms per call) imagemagick 0.64 sec ( 64 ms per call) n=10 to_file: False bounding box: None ------------------------------------------------------ wx 1.1 sec ( 109 ms per call) pygtk 1.3 sec ( 126 ms per call) pyqt 1.4 sec ( 135 ms per call) scrot 0.94 sec ( 94 ms per call) imagemagick 0.78 sec ( 78 ms per call) n=10 to_file: False bounding box: (10, 10, 20, 20) ------------------------------------------------------ wx 1 sec ( 101 ms per call) pygtk 0.62 sec ( 61 ms per call) pyqt 1.3 sec ( 127 ms per call) scrot 0.87 sec ( 87 ms per call) imagemagick 0.58 sec ( 57 ms per call) #-#
Print versions:
#-- sh('python -m pyscreenshot.check.versions 2> /dev/null ')--# pyscreenshot 0.3.4 wx 2.8.12.1 pygtk 2.28.6 pyqt not implemented scrot 0.8 imagemagick 6.7.7 #-#
command line help
#-- sh('python -m pyscreenshot.check.speedtest --help')--# usage: speedtest.py [-h] [-v] [--debug] optional arguments: -h, --help show this help message and exit -v, --virtual-display --debug set logging level to DEBUG #-#
#-- sh('python -m pyscreenshot.check.versions --help')--# usage: versions.py [-h] [--debug] optional arguments: -h, --help show this help message and exit --debug set logging level to DEBUG #-#
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pyscreenshot-0.4.1.tar.gz
.
File metadata
- Download URL: pyscreenshot-0.4.1.tar.gz
- Upload date:
- Size: 14.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
ddf2f5acdd6820046b6e8f53aebac7207d7ff193b0c4a3ca422d80c86693f473
|
|
MD5 |
a4240477f91ef4b143c441b5ed5f732c
|
|
BLAKE2b-256 |
1e42676685693cfcd6e711dfc3965bac6064443602bef58d21a5b6ea1cbe1aac
|