aos find

Find a button, menu item, link or text inside a window

1 command. Run aos find --help for the same list from the binary, or see every group.

Locate a button, menu item, link or text inside a window by its label, and get its bounds and center. It reads the accessibility tree first and falls back to OCR. Use it on its own to inspect, or let mouse click --find and draw --find do the lookup for you. Exit 3 means nothing matched.

Commands

aos find

Find text inside a window and print its global bounds and center

needs a display

aos find (<app> | --app=<name> | --title=<substring>) --text=<text> [--source=auto|accessibility|ocr] [--role=<role>] [--exact] [--all] [--no-raise] [--json]

flag	values	meaning
<app>		One of these is required
--app	<name>	One of these is required
--title	<substring>	One of these is required
--text	<text>	Required
--source	auto, accessibility, ocr	Optional
--role	<role>	Optional
--exact		Optional
--all		Optional
--no-raise		Optional
--json		Optional

aos find --app=Calculator --text=7
aos find Safari --text="Reload this page" --role=button --json
aos find --title=Settings --text=Wi-Fi --source=ocr --all
# exit 3 when the window or the text is not found