Skip to main content

mobium speech

This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET

Say what the screen reader says, about one element or walking the screen

Reports what the screen reader says — VoiceOver on a real iPhone (iOS 27, a runner built by Xcode 27), TalkBack on Android. With no target, the sentence for the element its cursor is on; with a target, the cursor is put on it first. --walk moves forward in the screen reader's own order, a swipe right at a time, until it goes no further, comes back round, or --limit moves are made. Each sentence is shown beside the element it was said about, and whether map lists that element — a heading or a status line is spoken and not listed.

The screen reader must be on: mobium accessibility screen_reader on. TalkBack is read from its log, which holds what it says only with its Developer settings' Log output level at VERBOSE. A sentence about a password field is not shown. A simulator's runner cannot reach VoiceOver and is refused.

--listen start, then an action, then --listen stop reports everything the screen reader said in between — on Android each with its cause: the cursor moving, an announcement by the app, or a change on screen such as a live region's.

Usage​

mobium speech [target] [flags]

Flags​

FlagTypeDefaultWhat it does
--limitint40Most moves a walk makes, or putting the cursor on the target takes on Android
--listenstringstart, before an action, or stop, after it, to hear what the screen reader said in between
--walkboolMove forward through the screen, reporting each sentence

And the global flags.

Examples​

Say what the screen reader says about the element its cursor is on​

mobium speech

Printed on an Android 15 emulator:

TalkBack says: "not checked. Pro. Radio button" — Pro (radio)

Walk the screen in the screen reader's order, each sentence beside its element​

mobium speech --walk --limit 20

Printed on an Android 15 emulator:

TalkBack says:
1. "not checked. Team. Radio button" — Team (radio)
2. "OFF. Dark mode. Switch" — Dark mode (switch)
3. "Dark mode, for the whole app" — Dark mode, for the whole app, not in map
4. "Read-only" — Read-only, not in map
5. "This field cannot be edited. Edit box. disabled"
6. "notify=false terms=false plan=free theme=light" — notify=false terms=false plan=free theme=light, not in map
7. (nothing)
8. "Back. Button" — Back (button)
9. "Form" — Form, not in map
10. "not checked. Email me. Check box" — Email me (checkbox)
11. "not checked. Accept terms. Check box" — Accept terms (checkbox)
12. "checked. Free. Radio button" — Free (radio)
13. "not checked. Pro. Radio button" — Pro (radio)
ended: the cursor came back round to the first element

Put the screen reader's cursor on an element, and hear what it says​

mobium speech label=Pro

Printed on an Android 15 emulator:

TalkBack says: "not checked. Pro. Radio button" — Pro (radio)

mobium speech label=Pro on an Android 15 emulator

mobium speech label=Pro on an Android 15 emulator

Start listening to the screen reader, before an action​

mobium speech --listen start

Printed on an Android 15 emulator:

listening to TalkBack — act, then stop it with listen stop

Stop listening, and hear what the action made it say​

mobium speech --listen stop

Printed on an Android 15 emulator:

TalkBack said, since listening started: "Live cart: 1" — Live cart: 1, not in map [a change on screen]

More, from mobium speech --help​

mobium speech
mobium speech --walk
mobium speech 'label="Form Demo"' --walk --limit 10
mobium speech --listen start; mobium tap testid=addLive; mobium speech --listen stop

The tool​

speech calls app_speech; its arguments and what every client calls it are there.