Skip the cutscene

pomme ui

SYSTEM NOTICE: The System couldn't be bothered to narrate this page. Enjoy the boring version, Crawler. The facts are the same either way.

Automate the guest through the host display.

pomme ui SUBCOMMAND

Type text into the guest display.

pomme ui type [--vm VM] [--text TEXT] [--text-env TEXT_ENV] [--replace] [--timeout TIMEOUT] [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Flag Description
--vm VM VM name. Uses POMME_VM_NAME when omitted.
--text TEXT Text to type.
--text-env TEXT_ENV Environment variable containing text to type.
--replace Press Command-A before typing so the text replaces the focused field’s contents. Off by default.
--timeout TIMEOUT Time limit in seconds.

This command also accepts the common flags.

Press a guest key.

pomme ui key [--vm VM] --key KEY [--timeout TIMEOUT] [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Flag Description
--vm VM VM name. Uses POMME_VM_NAME when omitted.
--key KEY Key name, such as return or cmd-shift-t. Run pomme ui keys for the names.
--timeout TIMEOUT Time limit in seconds.

This command also accepts the common flags.

Press a sequence of guest keys.

pomme ui key-sequence [--vm VM] [--timeout TIMEOUT] [--json] [--format FORMAT] [--debug] [--progress PROGRESS] -- [KEYS ...]
Argument Description
KEYS Key names after –, pressed in order.
Flag Description
--vm VM VM name. Uses POMME_VM_NAME when omitted.
--timeout TIMEOUT Time limit in seconds.

This command also accepts the common flags.

List the key names accepted by ui key and ui key-sequence.

pomme ui keys [--json] [--format FORMAT] [--debug] [--progress PROGRESS]

This command also accepts the common flags.

Click guest display coordinates.

pomme ui click [--vm VM] --x X --y Y [--timeout TIMEOUT] [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Flag Description
--vm VM VM name. Uses POMME_VM_NAME when omitted.
--x X Display x coordinate in points, from the left edge.
--y Y Display y coordinate in points, from the top edge.
--timeout TIMEOUT Time limit in seconds.

This command also accepts the common flags.

Capture the guest display.

pomme ui screenshot [--vm VM] --output OUTPUT [--timeout TIMEOUT] [--json] [--format FORMAT] [--debug] [--progress PROGRESS]
Flag Description
--vm VM VM name. Uses POMME_VM_NAME when omitted.
--output OUTPUT Host output file path.
--timeout TIMEOUT Time limit in seconds.

This command also accepts the common flags.


Generated from the help text of pomme 0.5.0 (34403a8-dirty).