Options

Show all options which differ from their default values.

Show all options.

Show value of option.

For boolean options, turn them on. For all other types, show their values.

For boolean options, turn them off. For all other types, display an error.

For boolean options, invert their value. For all other types, display an error.

For list options, toggle the specified values.

If the option is a list, the given values are toggled. Given,

then,

has the same result as

Reset option to its default value.

Set all options to their default value.

Set string or number option to value. For numeric options the value must be given in decimal. The old value can be inserted by typing .

Add the value to a number option, or append the value to a string option. When the option is a comma separated list, a comma is added, unless the value was empty. If the option is a list of flags, superfluous flags are removed. When adding a flag that was already present the option value doesn't change.

Multiply the value to a number option, or prepend the value to a string option. When the option is a comma separated list, a comma is added, unless the value was empty.

Subtract the value from a number option, or remove the value from a string option if it is there. If the value is not found in a string option, there is no error or warning. When the option is a comma separated list, a comma is deleted, unless the option becomes empty. When the option is a list of flags, value must be exactly as they appear in the option. Remove flags one by one to avoid problems.

The same as :set command, but operates on current tab options only. See :set for details.

The same as :set command, but operates on global options only. See :set for details.

Show the &dactyl.host; preferences dialog. You can change the browser preferences from this dialog. Be aware that not all &dactyl.host; preferences work, because &dactyl.appName; overrides some key bindings and changes &dactyl.host;'s GUI.

Opens about:config in the current tab, where you can change advanced &dactyl.host; preferences.

Change any &dactyl.host; preference (those on the about:config page). You can also reset/delete these preferences with :set! preference&.

A list of items which, when opened in a new tab, are automatically focused. Available items:

all

Activate all items.

addons

:addons command

bookmarks

Tabs loaded from bookmarks

diverted

Links with targets set to new tabs

downloads

:downloads command

extoptions

:extoptions command

help

:help command

homepage

gH mapping

links

Middle- or Control-clicked links

quickmark

go and gn mappings

tabopen

:tabopen! command

paste

P and gP mappings

Like wildmode, but when the key is pressed.

Enables automatic completion for completion groups matching the given regular expressions. When automatic completion is enabled, the completion list is automatically opened when the command-line is focused. Thereafter, any key press triggers a completion update for the matching groups (hereafter ‘contexts’). Non-matching contexts will only be updated when the key is pressed. This option is useful for disabling auto-completion for computationally intensive contexts that don't perform well when your system is under load.

See also :contexts

Replace occurrences of ! with the previous command when executing external commands.

List of directories searched when executing the :cd command. This is only used for relative paths; if an absolute path is specified, this option is ignored.

Items which are completed at the :open prompts. Available items:

s

Search engines and keyword URLs

f

Local files

l

&dactyl.host; location bar entries (bookmarks and history sorted in an intelligent way)

b

Bookmarks

h

History

S

Search engine suggestions

t

Open tabs

The order is important, such that :set complete=bsf will list bookmarks followed by matching quick searches and then matching files.

Sets the default search engine. The default search engine is used by :open and related commands for arguments which include no search or bookmark keywords and can't otherwise be converted into URLs or existing file names.

This means that with defsearch set to youtube, :open Tim Minchin behaves exactly as :open youtube Tim Minchin, so long as you don't have a search or bookmark keyword called ‘Tim’.

Set the external text editor. This is the editor used by , gF, and other commands which launch an external text editor.

Changes the character encoding of the current buffer. Valid only until a new page is loaded.

Ring the bell when an error message is displayed. See also visualbell.

A list of autocommand event names which should be ignored. If the list contains the value all then all events are ignored.

Allow reading of an RC file in the current directory. This file is sourced after the default &dactyl.name;rc file in your home directory.

Changes the character encoding that &dactyl.appName; uses to read and write files.

Changes how soon matching hints are followed in in Hints mode.

Possible values:

0

Follow the first hint as soon as typed text uniquely identifies it.

1

Follow the selected hint on .

2

Follow the selected hint on only if it's been -selected.

Show the current window full-screen. Also hide certain GUI elements, such as status-line and tab bar.

Show or hide certain GUI elements.

Supported characters:

B

Bookmark bar

C

Always show the command-line outside of the status line

M

Always show messages outside of the status line

N

Tab number over image

T

Toolbar

b

Bottom scrollbar

l

Left scrollbar (l and r are mutually exclusive)

m

Menu bar

n

Tab number

r

Right scrollbar

See also showtabline.

Name of the main help file. This is that page shown if the :help command is called without any arguments.

When generating hints for input elements that do not have an explicit caption, this specifies the methods used to generate a textual hint. The options are attempted in the order they are given, and the first successful value is used.

value

The hint is the value displayed in a text input, or the selected option for a drop-down.

label

The value of an explicit label for the input; this will not match most manually added labels that are found on sites.

name

The name of the input will be used; although the name is not designed for user consumption, it is frequently very similar to the label.

The keys used to label and select hints. With its default value, each hint has a unique number which can be typed to select it, while all other characters are used to filter hints based on their text. With a value such as asdfg;lkjh, each hint is ‘numbered’ based on the characters of the home row.

Change the hint matching algorithm used in Hints mode.

Possible values:

contains

The typed characters are split on whitespace, and these character groups have to match anywhere inside the text of the link.

wordstartswith

The typed characters are matched with the beginning of the first word (see wordseparators) in the link as long as possible. If no matches occur in the current word, then the matching is continued at the beginning of the next word. The words are worked through in the order they appear in the link. If the typed characters contain spaces, then the characters are split on whitespace. These character groups are then matched with the beginning of the words, beginning at the first one and continuing with the following words in the order they appear in the link.

firstletters

Behaves like wordstartswith, but non-matching words aren't skipped.

custom

Delegate to the function dactyl.plugins.customHintMatcher.

transliterated

Certain alphanumeric characters are translated into their unaccented equivalents, such that ‘euro’ will match 'æuró', and ‘Ångström’ will match ‘angstrom’.

The XPath string used to select for hinting. Can be overridden for individual extended-hints modes with the extendedhinttags option.

Timeout before automatically following a non-unique numerical hint. Set to 0 (the default) to only follow numeric hints after pressing or when the hint is unique.

Maximum number of Ex commands and search patterns to store in the command-line history.

Highlight previous search pattern matches.

Ignore case in search patterns.

Show the first match for a search pattern as it is typed.

Use Insert mode as the default for text areas. This is useful if you want to use the known &dactyl.host; interface for editing text areas. Input fields default to this behavior irrespective of this option's setting.

Textarea mode can be entered with from Insert mode.

Use the JavaScript debugger service for JavaScript completion.

Determines when the status line is shown.

Possible values:

0

Never

1

Only if there are multiple windows

2

Always

Limit searches to hyperlink text. This includes all elements matched by the hinttags XPath. This behavior can also be enabled by including \l in the search pattern, and disabled by including \L.

A regular expression list that defines which plugins are loaded at startup or via :loadplugins. The first item to match is the one that takes effect. If no items match, the file is not loaded. Setting this to a blank value effectively disables plugin loading.

For example, to prepend to the default value of this option to load all plugins except for foobar-plugin, you could use:

Alternatively, you can specify which plugins to load and which to omit in your &dactyl.name;rc using something like the below:

That will load all plugins but foo and bar.

Note that in the first expression of the latter example you don't need parentheses, as the ! negates the whole of the following expression (cf. regexlist).

See also :runtime.

Defines the replacement keys for the pseudo-key.

Maximum number of items to display at once in a listing.

Maximum number of messages to store in the message history.

Pause the message list window when more than one screen of listings is displayed.

Defines which Ex commands open pages in new tabs rather than the current tab by default. This may be overridden with the :tab command, and is usually inverted by affixing a ! to the command in question.

Possible values:

all

All commands

addons

:addons command

downloads

:downloads command

extoptions

:extoptions command

help

:help command

javascript

:javascript! or :js! command

prefs

:preferences! or :prefs! command

Patterns to use when guessing the next page in a document sequence after pressing the ]] key. Each pattern is successively tested against each link in the page (as defined by hinttags, starting with the last), and the first link to match is followed.

Enables or disables ‘offline’ mode, where network access is disabled and all web pages are loaded entirely from cache.

Info shown in the :pageinfo output.

Items available by default:

g

General info

f

Feeds

m

Meta tags

The order of the options defines the order in which they appear in the result.

Defines where to show requested pop-up windows. Applies only to links which request to open in a new window. The behavior of middle-, shift-, or control- clicking a link is unaffected by this option.

Possible values are:

tab

Open pop-ups in a new tab

window

Open pop-ups in a new window

resized

Open resized pop-ups in a new window

If neither tab nor window is provided, all pop-ups open in the current tab. tab and window are mutually exclusive, and the last one listed is effective.

Patterns to use when guessing the previous page in a document sequence after pressing the [[ key. Each pattern is successively tested against each link in the page (as defined by hinttags, starting with the last), and the first link to match is followed.

Set the private browsing option. In private browsing mode history, cache files, cookies, form data, passwords, download list entries, local and URL marks, command-line history and macros are available only for the duration of the private browsing session and deleted when returning to normal browsing mode. See also privacy.

List of directories searched for runtime files:

• colors/
• macros/
• plugins/

Example:

This will search for plugins in both ~/my&dactyl.name;/plugins and ~/.&dactyl.name;/plugins

On startup, if the environment variable $&dactyl.idName;_RUNTIME does not exist, &dactyl.appName; will set it to match this value.

Number of lines to scroll with and commands. The number of lines scrolled defaults to half the window size. When a count is specified to the or commands, that value is used instead. When the value is 0, it defaults to half the window height.

Shell to use for executing :! and :run commands.

Show the current mode in the command line.

Controls when the tab line is shown.

Possible values are:

0

Never show tab line

1

Show tab line only if more than one tab is open

2

Always show tab line

Override the ignorecase option if the pattern contains uppercase characters. This is only used if the ignorecase option is set.

Prevent scripts from focusing input elements without user intervention.

Set the search engines which can be used for completion suggestions when complete contains S.

Set the application name shown after the current page title in &dactyl.host;'s title bar.

The regular expression used to split URL lists in commands like :open. When set to the empty string, URL lists are never split. With the default value, the following will open three URLs in the current tab and two new background tabs,

Show current website with minimal styling.

Define which info messages are displayed. As the value increases, &dactyl.appName; will show more messages about its progress. These can be viewed at any time with the :messages command. The highest useful value is 15, being the most verbose mode.

Use visual bell instead of beeping on errors. The visual bell style is controlled by :highlight Bell. See also errorbells.

Regular expression list defining which completion groups show only matches anchored to the beginning of the result. The first matching expression is the one that applies. If the match is negated, then the current filter may match anywhere in the result. If it is not negated, then the match may only occur at the beginning of the result. If no items match, then a context-dependent default value is used.

Defines how completions are matched with regard to character case. Keys in the regexmap refer to completion context names (see :contexts) for which the value applies. Possible values are:

smart

Case is significant when capital letters are typed

match

Case is always significant

ignore

Case is never significant

List of file patterns to ignore when completing files. For example, the following will ignore object files and Vim swap files:

Defines how command-line completion works. It is a comma-separated list of parts, where each part specifies what to do for each consecutive press of the key. The last element in the list is used for each succeeding after it has been reached.

These are the possible values for each part:

Complete only the first match.

full

Complete the next full match. After the last, the original string is used.

longest

Complete the longest common substring of all completions.

list

When more than one match, list all matches.

list:full

When more than one match, list all matches and complete the first match.

list:longest

When more than one match, list all matches and complete till the longest common string. When there is only a single match, it is fully completed regardless of the case.

See also altwildmode.

A list of regular expressions defining which completion contexts should be sorted. The main purpose of this option is to prevent sorting of certain completion lists that don't perform well under load.

See also :contexts