&dactyl.host;'s GUI

Although &dactyl.appName; offers access to the most frequently used &dactyl.host; functionality via Ex and Normal mode commands, there may be times when direct access to the &dactyl.host; GUI is required. For such eventualities, there are commands to access menu items and to launch standard &dactyl.host; dialogs.

Menus

:emenu :emenu menu

Execute menu from the command line. This command provides command-line access to all menu items available from the main &dactyl.host; menubar. menu is a hierarchical path to the menu item with each submenu separated by a period. E.g. :emenu File.Open File… launches the standard &dactyl.host; ‘Open File’ dialog.

Dialogs

:ao :addo :addons :addons

Opens the add-on list.

:dia :dialog :dialog &dactyl.host;-dialog

Open a &dactyl.host; dialog. Available dialogs include:

:dl :downl :downloads :downloads

Show progress of current downloads. Here, downloads can be paused, resumed, and canceled.

Available options include:

-sort
Sort order (see downloadsort) (short name: -s)
:dlc :dlclear :dlclear

Clear completed downloads.

Add-ons

The following commands manipulate the currently installed add-ons. With the exception of :extadd, they all except the following arguments:

-types
The types of add-ons to operate on, the most common types being extension, theme, and plugin (short names -type, -t)
:exta :extadd :extadd file|url

Install an extension. file|uri must be the local file path or URL of an XPInstall (.xpi) file.

:extrm :extde :extdelete :extdelete extension :extdelete!

Uninstall an extension. extension is the extension's name. When ! is given all extensions are uninstalled.

:extd :extdisable :extdisable extension :extdisable!

Disable an extension. extension is the extension's name. When ! is given all extensions are disabled.

:exte :extenable :extenable extension :extenable!

Enable an extension. extension is the extension's name. When ! is given all extensions are enabled.

:exto :extoptions :extoptions! extension :extp :extpreferences :extpreferences! extension

Open the preferences dialog for an extension. If ! is given, open a dialog, otherwise open a buffer. See also newtab.

:extr :extrehash :extrehash extension :extrehash

Toggle an extension's enabled status twice. This is useful for rebooting a restartless extension.

:extt :exttoggle :exttoggle extension :exttoggle

Toggle an extension's enabled status.

:extu :extupdate :extupdate extension :extupdate!

Update an extension. When ! is given, update all extensions.

Sidebar

:sbcl :sbclose :sbclose

Close the sidebar window.

:sbope :sbopen :sb :sbar :sideb :sidebar :sidebar name

Open the sidebar window. name is any of the menu items listed under the standard &dactyl.host; View->Sidebar menu. Add-ons, Preferences and Downloads are also available in the sidebar.

:sidebar! name

Toggle the sidebar window. When name is provided, the semantics are as follows: If the named sidebar is currently open, it is closed. Otherwise the named sidebar is opened. When name is not provided, the semantics are as follows: If the sidebar is currently open, it is closed. Otherwise the previously open sidebar panel is re-opened.

Status line

The status line appears at the bottom of each window. You can use guioptions to specify if and when the status line appears, as well as its relation to the command line and messages.

The status line contains several fields that provide information about the state of the current buffer. These are, in order:

  • URL: The URL of the currently loaded page. While the page is loading, progress messages are also output to this field.
  • History and bookmark status ([+-❤⋯]): The position of the current page in the tab's session history; - and + indicate that it is possible to move backwards and forwards through the history respectively. ❤ indicates that the current page is bookmarked. Any other character indicates a QuickMark matching the current page.
  • Tab index ([N/M]): N is the index of the currently selected tab and M is the total number of tabs in the current window.
  • Vertical scroll: The vertical scroll percentage of the current buffer, or Top or Bot for the top and bottom of the buffer respectively.
  • Security: The security information button is displayed when appropriate as per &dactyl.host;. The color of the status bar also changes to reflect the current security status of the loaded page.
    black
    The site's identity is unverified and the connection is unencrypted
    red
    The connection is encrypted, but the site's identity has not been verified or it contains unencrypted content
    blue
    The site's domain has been verified and the connection is encrypted
    green
    The site's domain and owner have been fully verified via an Extended Validation certificate and the connection is encrypted
  • Extensions: Any extension buttons that would normally be installed to the &dactyl.host; status bar are appended to the end of the status line.

Toolbars

:tbs :tbshow :toolbars :toolbarshow :toolbarshow name

Shows the named toolbar.

:tbh :tbhide :toolbarh :toolbarhide :toolbarhide name

Hides the named toolbar.

:tbt :tbtoggle :toolbart :toolbartoggle :toolbartoggle name

Toggles the named toolbar.