Open Records and copy the first community formation.

Copy suggested formations from records. Args: formations: Number of formations to try skip_manual: Skip formations la

Create test video with specific dimensions.

Convert MM/DD date string to English weekday name.

Ensure we're on the battle screen, navigating if necessary.

Auto-install optional OCR backends if the user has opted in.

Install or fix torch+Qwen2-VL deps, ensuring GPU (CUDA) support.

Enter Dream Realm.

Navigate to the Ravaged Realm screen via hamburger menu > Events.

Enter Supreme Arena.

Execute battle sequence. Returns: bool: Whether the battle was successfully completed

Execute a single proxy battle. Returns: bool: Whether the battle was successfully completed

Extract categories from menu options, preserving order and uniqueness.

Extract the player name, filtering out guild names by Y position.

Crop the rank badge area near ref_y and OCR for digits.

Fetch guild member names from the configured API URL for name correction.

Correct names, discard non-guild noise, and deduplicate by name.

Finds colors fast. Returns: x coordinate of the box, x coordinate of the hook

Find matching popup message using fuzzy substring matching. Args: ocr_text: Text detected by OCR similarity_threshold

Find proxy battle banner. Returns: Optional[Point]: Banner location, or None if not found

Locate the retry button if present.

Find Synergy or Corrupt Creature.

Skip formations with excluded heroes. Returns: str | None: Name of excluded hero

Fulfill requests best-first until a craft cycle or exhaustion. Each iteration compares the four request portraits by their Wish Point

Fulfill the currently selected request once via Quick Select. Taps Quick Select and then either crafts a missing resource or delivers

Returns a list of available H264 decoders.

Find and cache the best available H264 decoder.

Parse BlueStacks config files to find configured ADB ports.

Get codec context using cached decoder selection.

Attempts to list ADB devices. Args: client (AdbClient): ADB client instance used for connection. Raises: AdbException: Faile

Get the menu for the GUI. Used by the Wails GUI to populate the menu.

Return full /proc/bus/input/devices contents.

Scan running processes for emulators and extract their ports.

Handle ambiguous result screen.

Confirm popups. Returns: bool: True if confirmed, False if not.

Handle Corrupt Creature.

Wait for crafting screen, cycle multiplier to x10, press action button. If the action button is greyed out, a required ingredient is missing

Click the highest-priority dialogue or action button on screen.

Select heroes for battle, optionally excluding previously failed heroes. Args: exclude_heroes: List of hero template paths to exc

Check for buttons on screen that we need to hold down.

Repeatedly open Requests, pick the best-rewarded order and fulfill it. Each time the Requests view is entered, the four request portraits are

Handle power up screen.

Handle Fitz's Shop.

Handle time-change and outfit-change prompts.

Handle the stuck state. Returns True if count should be reset.

Handle Synergy.

Handle two-pass battle: first non-manual, then manual. Args: use_suggested_formations: if True copy formations from Records

Initialize Tesseract once and cache the result. Raises: RuntimeError: If Tesseract cannot be found or initialized

Whether the battle was successful. None is for unclear scenarios, None cases should be replaced by Exceptions.

Check if current formation is manual. Returns: True if formation is manual, False otherwise.

Join proxy battle. Args: banner_location: Banner location Returns: bool: Whether successfully joined

Kill the ADB process directly using psutil.

Build a hashable key similar to functools.lru_cache.

Return True if `name` has more observations at any rank other than `rank`. Used to exclude alt candidates that truly belong at a different ra

From the Guild Hall, open Guild Chest and tap Contribution Ranking tab. Returns True if the Contribution Ranking screen is reached.