dc-adb-images 0.0.1

ADB-based image and text automation utilities for Android devices

📸 adb_images Module

The adb_images module provides advanced image and text automation features using ADB, OpenCV, and Tesseract OCR.
It allows developers to capture screenshots, match UI elements visually, and interact with text on the screen.

---

✨ Features

• Capture device screenshots
• Match and locate images on screen
• Tap or long‑press on matched images
• Preprocess screenshots for OCR
• Extract and verify text using Tesseract
• Tap on recognized text safely with retry protection

---

📚 Installation

pip install dc-adb-images

🚀 Usage Example

from adb_images.image_controller import ImageController
from adb_images.image_matcher import ImageMatcher
from adb_images.text_recognizer import TextRecognizer
from adb_images.text_tapper import TextTapper

# Initialize controllers
controller = ImageController(device_id="emulator-5554")
matcher = ImageMatcher(device_id="emulator-5554")
recognizer = TextRecognizer(device_id="emulator-5554", dir_path=r"C:\Config\Tesseract-OCR\tesseract.exe")
tapper = TextTapper(device_id="emulator-5554")

# Capture a screenshot
screenshot_path = controller.capture_screen()
print(f"Screenshot saved at: {screenshot_path}")

# Find and tap an image
coords = matcher.match_image("assets/target_button.png")
if coords:
    matcher.tap_point(*coords)

# Recognize and tap text
if recognizer.process_text("Login"):
    print("Login button tapped successfully")

# Tap text with preprocessing and safe retries
if tapper.process_text("Continue"):
    print("Continue tapped safely")