Commands
tap
Tap a point in the screenshot, a @t ref from look, or a line of text found on screen.
Usage
zeptap tap <x> <y> [--expect <text>]
zeptap tap @tN
zeptap tap --text <text> [--index <n>] [--exact]Options
| Option | Description |
|---|---|
<x> <y> | Whole pixels in the latest screenshot, origin top-left |
@tN | A ref from the last look. Checked against the screen before tapping |
--text <text> | Find the line on screen and tap its center: an exact match first, then a line containing the text |
--index <n> | When several lines match --text, tap the nth (1-based, top to bottom) |
--exact | With --text, only accept a whole-line match |
--expect <text> | With <x> <y>, refuse the tap unless this text is at the point |
Also takes the global options, including --look.
Details
- After the tap, the command waits for the screen to settle, prints the target, and saves a screenshot.
- Prefer a ref or
--textto estimated coordinates: OCR finds the label's exact center. - A ref whose text moved a little taps the new spot. A ref whose text went away is refused with exit code 3. Run
lookagain. - When
--textmatches several lines, nothing is tapped. The command lists the matches with fresh refs and exits with code 2: pass--indexor one of the refs. --expectis for taps where a miss would post, send or delete. A refused tap exits with code 3 and lists where the text was seen.- A tap on a button that pays or places an order waits until the user approves it on the Mac. If they don't, nothing is tapped.
Examples
$ zeptap tap -l 7 @t4 --look
$ zeptap tap -l 7 --text "Next"
$ zeptap tap -l 7 --text "Follow" --index 2
$ zeptap tap -l 7 412 1188
$ zeptap tap -l 7 540 1210 --expect "Send"