Skip to main content

Your submission was sent successfully! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates from Canonical and upcoming events where you can meet our team.Close

Thank you for contacting us. A member of our team will be in touch shortly. Close

`client.gui.hotkey`

This setting has been removed from the CLI starting from Multipass version 1.14.
It is now only available in the GUI client.

See also: get, set, GUI client

Key

client.gui.hotkey

Description

A keyboard shortcut for the GUI to open a shell into the primary instance.

Possible values

A single case-insensitive sequence of keys, containing:

  • zero or more modifiers (such as Ctrl, Alt, Cmd, Command, Opt, etc.)
  • one non-modifier key (such as u, 4, ., Space, Tab, Pause, F3). When key names have multiple words, quote and use spaces (for example: "Print Screen").
  • (on macOS) alternatively, UTF-8 characters for Mac keys (such as ⌘, ⌥, ⇧, ⌃)
  • a plus (+) sign separating each alphabetic word (but not key symbols) from the next
  • the empty string ("") to disable the hotkey

Caveats:

  • There are some limitations on what keys and combinations are supported, depending on multiple factors such as keyboard, mapping, and OS (e.g. AltGr, numpad, or media keys may or may not work; shift+enter is rejected).
  • Some combinations may be grabbed by the OS before they reach multipass (e.g. meta+a may open the Applications, ctrl+alt+f3 may move ttys).

Examples

  • multipass set client.gui.hotkey="Ctrl+Print Screen".
  • multipass set client.gui.hotkey="⌃⇧Y".
  • multipass set client.gui.hotkey=option+space.
  • multipass set client.gui.hotkey=""

Default value

  • Ctrl+Alt+U on Linux and Windows
  • ⌥⌘U on macOS

Errors or typos? Topics missing? Hard to read? Let us know or open an issue on GitHub.

Last updated 3 months ago. Help improve this document in the forum.