Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Key bindings

? shows the bindings inside virsh-tui. The overlay is built from the active key map, so it reflects your keymap.toml. Type to filter it.

Default bindings

KeyActionName
j / kdown / upmove_down / move_up
gg / Gtop / bottomgo_top / go_bottom
Ctrl-d / Ctrl-uhalf page down / uphalf_down / half_up
Enteropenopen
Backspace, qback (q quits from the top level)back
/filterfilter
n / Nnext / previous matchnext_match / prev_match
H / L, [ / ]previous / next tabprev_tab / next_tab
1 … 5Domains, Host, Networks, Storage, Eventsview_domains … view_events

Domain actions

KeyActionName
sstartstart
SACPI shutdownshutdown
Ddestroy (force off)destroy
rrebootreboot
Rresetreset
ppause / resumepause
Zmanaged save (suspend to disk)managed_save
atoggle autostartautostart
cserial consoleconsole
vgraphical viewerviewer
eedit XMLedit_xml
Xundefineundefine

Copy

KeyCopiesName
yynameyank_name
yuUUIDyank_uuid
yiIP addressyank_ip
yclast commandyank_cmd

Leader (Space)

KeyActionName
Space nnew domainnew_domain
Space ccloneclone
Space rrenamerename
Space Mmigratemigrate
Space s c / s r / s dsnapshot create / revert / deletesnapshot_new / snapshot_revert / snapshot_delete
Space m i / m einsert / eject ISOinsert_media / eject_media
Space d a / d rattach / resize diskdisk_attach / disk_resize
Space i a / i lattach NIC / toggle linknic_attach / nic_link
Space xexport XMLexport_xml
Space bboot orderboot_order
Space l / Space Lpin / unpin a DHCP leaselease_pin / lease_unpin

Lists and monitor

KeyActionName
mmark / unmarkmark
Vvisual selectionvisual
ocycle sortsort_cycle
f / Fcycle filter chipschip_cycle / chip_cycle_back
thistory window 60 s / 5 min / 1 hwindow_cycle
lfocus the leases table (Networks)lease_focus
uundo field (hardware editor)undo_field
gxgo to the XML tabgoto_xml

App

KeyActionName
:command lineex
Ctrl-pcommand palettepalette
?helphelp
,settingssettings
Ctrl-rrefresh nowrefresh
Ctrl-lredraw the screenredraw
.repeat the last change
q, ZZ, Ctrl-cquitquit

Some screens add their own keys, listed in the status bar: the hardware editor, the wizard, Networks and Storage.

Remapping keys

Create ~/.config/virsh-tui/keymap.toml:

[normal]
shutdown = ["S", "Space q"]      # several bindings for one action
snapshot_new = ["Space s n"]     # tokens separated by spaces
console = ["C-t"]
  • Each entry maps an action name (the “Name” column above) to a list of key sequences.
  • A sequence is a list of tokens separated by spaces. A token is a single character (a, A, :), C-x for Ctrl, or one of Space, Enter, Esc, Tab, S-Tab, Backspace.
  • Remapping an action removes its default keys. List them again if you want to keep them.
  • Sub-tables such as [normal.domains] are accepted to group entries, but their bindings apply in every view.

Unknown action names and syntax errors are reported in the message line when virsh-tui starts; the rest of the file still applies. The help overlay and the which-key popup show your bindings.

All action names: move_up, move_down, go_top, go_bottom, half_down, half_up, open, back, filter, next_match, prev_match, start, shutdown, destroy, reboot, reset, pause, managed_save, managed_save_remove, autostart, console, viewer, edit_xml, undefine, rename, clone, migrate, send_key, export_xml, new_domain, yank_name, yank_uuid, yank_ip, yank_cmd, mark, visual, sort_cycle, chip_cycle, chip_cycle_back, window_cycle, lease_focus, lease_pin, lease_unpin, ex, palette, help, settings, refresh, redraw, quit, quit_all, snapshot_new, snapshot_revert, snapshot_delete, insert_media, eject_media, disk_attach, disk_resize, nic_attach, nic_link, boot_order, prev_tab, next_tab, undo_field, goto_xml, view_domains, view_host, view_networks, view_storage, view_events.