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, foo,bar then, foo,baz has the same result as bar,baz

This extends to string options in a natural way, e.g., always,never toggles between the two values.

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&.

Like wildmode, but when the key is pressed.

Enables automatic completion for completion contexts (see :contexts) matching the given regular expressions. When automatic completion is enabled, the completion list is automatically opened when the &tag.command-line; is focused. Thereafter, any key press triggers a completion update for the matching 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.

To go in the other direction, i.e. only enable auto-completion for those commands, you have to jump through some hoops, due to the way contexts work (see the note above): /ex/(bmarks|history),^(/|/ex/?)$

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.

If the CDPATH environment variable is set this path list is appended to the default value of ..

When to accept cookies.

all

Accept all cookies

none

Accept no cookies

samesite

Accept all non-third-party cookies

The lifetime for which to accept cookies. The available options are:

default

The lifetime requested by the setter

prompt

Always prompt for a lifetime

session

The current session

days

When a number is given, it is interpreted as the number of days for which to keep cookies

The default action for the :cookies command.

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

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

:downloads sort order, in order of precedence. Each element must be preceded by a + or -, indicating ascending or descending sorting, respectively. Valid sort orders are:

active

Whether download is active

complete

Percent complete

date

Date and time the download began

filename

Target filename

size

File size

speed

Download speed

time

Time remaining

url

Source URL

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.

Accepts a macro-string with the following escapes available. Arguments containing escapes which are not relevant to a given call are automatically elided. All field splitting is done before format characters are processed.

<file>

The file to edit. Appended as the final argument if missing.

<line>

The line number at which to position the cursor.

<column>

The column at which to position the cursor.

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.

Find case matching mode.

ignore

Case is never significant

match

Case is always significant

smart

Case is significant when capital letters are typed

Define the conditions under which selected hints are followed.

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

c

Always show the command line, even when empty

l

Left scrollbar (l and r are mutually exclusive)

m

Menu bar

n

Tab number

r

Right scrollbar

s

Status bar

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 transliterated into their unaccented equivalents, such that ‘euro’ will match 'æuró', and ‘Ångström’ will match ‘angstrom’.

Timeout in milliseconds before automatically following a non-unique hint. The timeout is measured since the last time a key listed in hintkeys was pressed. It has no effect when narrowing hints by typing part of their text. Set to 0 (the default) to only follow hints after pressing or when the hint is unique.

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

Highlight previous find pattern matches.

Show the first match for a find 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.

TextEdit mode can be entered with from Insert mode.

Use the JavaScript debugger service for JavaScript completion.

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 following:

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. regexplist).

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

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

e

Search Engines

f

Feeds

m

Meta tags

s

Security information

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

Pass certain keys through directly for the given URLs. For any page with a URL matching a given regexp, all key events for keys listed in that regexp's value are passed through directly to &dactyl.host;, and are not processed by &dactyl.appName; in any way. Key names are separated by commas, where the first key name is treated as a list of individual keys and each subsequent key is treated as a key chain. Individual key entries always apply to all modes. Key chains apply only to non-input modes unless they begin with a key requiring a modifier other than shift.

More subtle and complex pass through can be achieved using groups and mode-specific mappings utilizing the pseudo-key.

Pass unknown keys through to &dactyl.host; in these modes. The first element matching a currently active mode is the one that takes effect. Modes may be negated by prefixing them with a !.

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.

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.

The items to sanitize automatically at shutdown.

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 if it or any of its parent modes is included in the list. Modes may be negated by prefixing them with a !.

Define when the tab bar is visible.

always

Always show the tab bar

multitab

Show the tab bar when there are multiple tabs

never

Never show the tab bar

Prevent scripts from focusing input elements without user intervention.

Possible values:

despotic

Only allow focus changes when explicitly requested by the user

laissez-faire

Always allow focus changes

moderate

Allow focus changes after user-initiated focus change

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

When this option is set and a key sequence interpretable both as a complete command and as a start of a longer command is typed, execute the shorter command after timeoutlen milliseconds.

Maximum number of milliseconds to wait for a longer key command when a shorter one exists. Only effective when timeout is set.

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.

Defines how completions are matched with regard to character case. Keys in the regexpmap 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.