Skip to main content

No project description provided

Project description


PyPI version

zbl is a Rust and Python library aiming to make it easier to integrate OpenCV (and possibly other CV libraries) with Windows Desktop apps for real-time processing. It does so by providing a simplified interface to Windows.Graphics.Capture.

This library is not well-tested against corner cases, and was only verified to work for a 'happy path' scenarios, so beware of bugs!



pip install zbl

Alternatively, you can install suitable wheel from releases page.


from zbl import Capture

with Capture(window_name='visual studio code') as cap:
    frame = next(cap.frames())

The snippet above will capture a window which title contains the string visual studio code, take one frame (which is represented as a numpy array) and print its shape.

To run an example using OpenCV's highgui:

  1. Install opencv-python
  2. Run python -m zbl --window-name '<full or partial window name, case insensitive>'


See examples. Note: if you are getting OpenCV build errors when building the example, check out how to build OpenCV rust bindings.

Why not mss / pyautogui?

Those are the definition of "slow" at the time of writing. mss tops at 30-50 fps in a tight loop, pyautogui is even slower than that. Due to GPU accel which comes with D3D11, zbl captures at 500-700 fps - an order of magnitude faster, which allows a lot more time for the actual processing.

Why Rust for the native code part and not C++ / C#?

I need it for the Rust project, hence it is in Rust.


zbl is heavily inspired by screenshot-rs.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

zbl-0.1.0-cp311-none-win_amd64.whl (191.6 kB view hashes)

Uploaded cp311

zbl-0.1.0-cp310-none-win_amd64.whl (191.6 kB view hashes)

Uploaded cp310

zbl-0.1.0-cp39-none-win_amd64.whl (191.8 kB view hashes)

Uploaded cp39

zbl-0.1.0-cp38-none-win_amd64.whl (192.2 kB view hashes)

Uploaded cp38

zbl-0.1.0-cp37-none-win_amd64.whl (192.2 kB view hashes)

Uploaded cp37

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page