Options

Show all options that differ from their default value.

Show all options.

Show value of option.

Toggle option

set, switch it on.

Number option

show value.

String option

show value.

Toggle option: Reset, switch it off.

Toggle option: Invert value.

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 &liberator.host; preferences dialog. You can change the browser preferences from this dialog. Be aware that not all &liberator.host; preferences work, because &liberator.appname; overrides some key bindings and changes &liberator.host;'s GUI.

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

Change any &liberator.host; preference (those in the about:config window). You can also reset/delete those preferences with :set! preference&.

Define when tabs are automatically activated. Available items:

homepage

gH mapping

quickmark

go and gn mappings

tabopen

:tabopen[!] command

paste

P and gP mappings

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

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

s

Search engines and keyword URLs

f

Local files

l

&liberator.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, so :set complete=bs would list bookmarks first, and then any available quick searches.

Sets the default search engine. The default search engine name is used in the :open [arg] command if [arg] neither looks like a URL nor like a specified search engine/keyword.

This means that if you set defsearch to youtube, then :open arnold schwarzenegger will be exactly the same as :open youtube arnold schwarzenegger. Therefore, you need to add a keyword or search engine youtube first.

If defsearch is empty, then &liberator.host; will always attempt to open the raw [arg].

Set the external text editor. Sets the editor to run when is pressed in Insert and TextArea modes.

Allow reading of an RC file in the current directory. This file is sourced in addition to, and after, your default RC file.

The XPath string of hintable elements activated by ;.

Ring the bell when an error message is displayed.

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

Changes the character encoding of the current buffer. Valid only for the current page.

Changes the character encoding that &liberator.appname; uses to read and write files.

Focus the content after a page has loaded. This is useful if you always want to stay in Normal mode when browsing between web sites. When on, it blurs any textbox which often is automatically focused on page load. If you usually like focuscontent but sometimes you'd like to focus the first input field, you can use gi to jump to it.

Change the behaviour of 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 fullscreen. Also hide certain GUI elements like the statusline.

Show or hide certain GUI elements like the menu or toolbar.

Supported characters:

m

Menubar

T

Toolbar

B

Bookmark bar

n

Tab number

N

Tab number over image

b

Bottom scrollbar

r

Right scrollbar

l

Left scrollbar (l and r are mutually exclusive)

You can also hide the tab bar with :set showtabline=0.

Name of the main help file. This is the tail component of the chrome URL as displayed in the status line when viewing the page.

When generating hints for input elements that do not have an explicit caption, this specifies the methods to try and generate a textual hint. It tries the options in the order that you give, and uses the first that it finds.

value

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

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.

Change the hint matching algorithm during 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 overleaped.

custom

Delegate to a custom function: liberator.plugins.customHintMatcher(hintString)

XPath string of hintable elements activated by f and F

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.

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

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.

Highlight previous search pattern matches

Ignore case in search patterns.

Show where the search pattern matches as it is typed.

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

Textarea mode can be entered with from Insert mode.

Determines when the last window will have a status line.

Possible values:

0

Never

1

Only if there are multiple windows

2

Always

Limit the search to hyperlink text. This includes (X)HTML elements with an href atrribute and XLink simple links.

Load plugin scripts when starting up. When on, yet unloaded plugins are automatically loaded after the &liberator.name;rc file has been sourced. To load plugins earlier, use the :loadplugins command within the &liberator.name;rc.

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

Number of messages to store in the message history.

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

Patterns to use when guessing the next page in a document sequence when the user hits ]]. Each pattern, in order, is matched against all links in the page with the first match being used. The patterns are case insensitive regular expressions and the link elements are those defined by hinttags.

Define which Ex commands output the result in a new tab automatically. You can also use :tab command to manually output a command in a new tab.

The possible values:

all

All commands

addons

:addo[ns] command

downloads

:downl[oads] command

extoptions

:exto[ptions] command

help

:h[elp] command

javascript

:javascript! or :js! command

prefs

:pref[erences]! or :prefs! command

Show and set the 'work offline' behavior.

Desired info in the :pageinfo output.

Available items:

g

General info

f

Feeds

m

Meta tags

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

Define where to show requested popup windows. Does not apply to windows which are opened by middle clicking a link, they always open in a new tab.

Possible values:

tab

Open popups in a new tab

window

Open popups in a new window

resized

Open resized popups in a new window

If neither tab nor window is provided, all popups 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 when the user hits [[. Each pattern, in order, is matched against all links in the page with the first match being used. The patterns are case insensitive regular expressions and the link elements are those defined by hinttags.

List of directories searched for runtime files:

• colors/
• macros/
• plugin/

Example:

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

On startup, if the environment variable $&liberator.idname;_RUNTIME does not exist, &liberator.appname; will set it to match this value.

The default list of private items to sanitize.

cache

Cache

commandline

Command-line history

cookies

Cookies

downloads

Download history

formdata

Saved form and search history

history

Browsing history

marks

Local and URL marks

macros

Saved macros

offlineapps

Offline website data

passwords

Saved passwords

sessions

Authenticated sessions

sitesettings

Site preferences

When history items are sanitized :open, :tabopen and :winopen command-line history entries are also removed.

The default sanitizer time span. Only items created within this timespan are deleted.

0

Everything

1

Last hour

2

Last two hours

3

Last four hours

4

Today

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 this is used to set the value of scroll and also used for the current command. The value can be reset to half the window height with :set scroll=0.

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

Flag passed to shell when executing :! and :run commands.

Show the current mode in the command line.

Show the destination of the link under the cursor in the status bar. Also links which are focused by keyboard commands like are shown.

Possible values:

0

Don't show link destination

1

Show the link in the status line

2

Show the link in the command line

Control when to show the tab bar of opened web pages.

Possible values:

0

Never show tab bar

1

Show tab bar only if more than one tab is open

2

Always show tab bar

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

Set the search engines which can be used for completion suggestions. Add S to the complete option if you want to use this feature.

Change the title of the browser window. &liberator.appname; changes the browser title from Title of web page - Mozilla &liberator.host; to Title of web page - &liberator.appname;. If you don't like that, you can restore it with:

Show current website with a minimal style sheet to make it easily accessible.

Set the separator regex used to separate multiple URL args. Multiple arguments can be specified for :open, and similar commands, using this regex as the separator. Using whitespace alone is not generally useful since it is often contained in a single argument. E.g., :open linus torvalds should perform a single search for the key words linus and torvalds. If this is set to the empty string then these arguments will never be split.

Define which info messages are displayed. When bigger than zero, &liberator.appname; will give messages about what it is doing. These can be viewed at any time with the :messages command. The highest value is 15, being the most verbose mode.

Use visual bell instead of beeping on errors. The visual bell style is controlled by :hi Bell.

To disable both the audible and visual bells use :set visualbell and :hi Bell display: none;

Defines how completions are matched with regard to character case. Possible values:

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. E.g., to ignore object files and Vim swap files :set wildignore=.\\.o,\\..\\.s[a-z]\\2

Defines how command-line completion works. It is a comma-separated list of parts, where each part specifies what to do for each consecutive use of the completion key. The first part specifies the behavior for the first use of the completion key, the second part for the second use, etc.

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 till the longest common string.

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.

A list of words that change how command-line completion is done.

Possible words:

auto

Automatically show completions while you are typing.

sort

Always sort the completion list, overriding the complete option.

A regex which defines the word separators which are used for the hintmatching types wordstartswith and "firstletters" to split the words in the text of a link.