Skip to main content

Interactive screen region selection returning a NumPy array.

Project description

Contributors Forks Stargazers Issues License

Screen Region Selector

A lightweight Python library for interactively selecting a region of your screen and retrieving it as a NumPy array.

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. License
  5. Contact

About The Project

Screen Region Selector is a lightweight Python library that lets users interactively select a region of their screen and instantly retrieve the selected area as a NumPy array.

The library is designed for applications such as:

  • Computer vision
  • OCR
  • Machine learning datasets
  • Automation tools
  • Screenshot utilities

The returned image is a standard RGB NumPy array, making it easy to integrate with libraries such as OpenCV, Pillow, or custom image-processing pipelines.

(back to top)

Built With

  • Python
  • NumPy
  • MSS
  • ScreenInfo
  • Tkinter (built into Python)

(back to top)


Getting Started

Requirements

  • Windows
  • Python 3.10+

Installation

Install from PyPI:

pip install screen-region-selector

Or install the latest development version:

pip install git+https://github.com/MarcyVibin/screen-selector.git

Usage

from screen_selector import select_region

image = select_region()

print(image.shape)

The returned object is a NumPy ndarray in RGB format.


License

Distributed under the GNU General Public License v3.0 (GPL-3.0). See LICENSE for more information.


Contact

Marc Steger - marc.steger06@gmail.com

Project Link: https://github.com/MarcyVibin/screen-selector

(back to top)

Project details


Download files

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

Source Distribution

screen_region_selector-0.1.0.tar.gz (17.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

screen_region_selector-0.1.0-py3-none-any.whl (17.5 kB view details)

Uploaded Python 3

File details

Details for the file screen_region_selector-0.1.0.tar.gz.

File metadata

  • Download URL: screen_region_selector-0.1.0.tar.gz
  • Upload date:
  • Size: 17.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.4

File hashes

Hashes for screen_region_selector-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b58c61d5b86086ee78e5632397f09a13708cf5ac4fd9a9333e05024660cb4fee
MD5 23f2b305f501eb76f204961bf13bb592
BLAKE2b-256 112bec3163a5c889348f61b7ef4d204c53f522bcf4fb1b2e71f0e68f766df90c

See more details on using hashes here.

File details

Details for the file screen_region_selector-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for screen_region_selector-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4bb8acd29958d67671b30453ae12ef37d6c18e89d0a4f7cf7df217d16dc04c7c
MD5 fed81a82f59e61f95f5b306bc02d224b
BLAKE2b-256 9bbf587c647b89f74a2c2a320ece04d98910528fc15651774df18d7b85c3cd00

See more details on using hashes here.

Supported by

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