Skip to content

pomme ui

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.1.0 (2cde15f-dirty).