Vimperator has a number of internal variables and switches which can be set to achieve special effects. These options come in 5 forms:
Show all options.
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
:set opt=foo,bar
then,
:set opt!=foo,baz
has the same result as
:set opt=bar,baz
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 <Tab>.
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.
Environment variables are expanded for path options like 'cdpath' and 'runtimepath'. The variable notation is $VAR (terminated by a non-word character) or ${VAR}. %VAR% is also supported on Windows.
Swiftweasel options can be viewed and set with the following commands:
Show the Swiftweasel preferences dialog. You can change the browser preferences from this dialog. Be aware that not all Swiftweasel preferences work, because Vimperator overrides some key bindings and changes Swiftweasel's GUI.
Opens about:config in the current tab where you can change advanced Swiftweasel preferences.
Change any Swiftweasel {preference} (those in the about:config window). You can also reset/delete those preferences with :set! preference&.
Vimperator sets several Swiftweasel preferences at startup. If this is undesirable, they can be changed to a different value in your RC file using :set! preference=value
The following preferences are set:
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:
The order is important, so :set complete=bs would list bookmarks first, and then any available quick searches.
Warning: Using b and h can make completion very slow if there are many items.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 Swiftweasel will always attempt to open the raw [arg].
Set the external text editor. Sets the editor to run when <C-i> is pressed in Insert and TextArea modes.
Warning: Vimperator will not behave correctly if the editor forks its own process, such as with gvim without the -f argument.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 Vimperator 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.
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:
You can also hide the tab bar with :set showtabline=0.
Note: Scrollbar changes require a page reload to take effect.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.
Change the hint matching algorithm during Hints mode.
Possible values:
Timeout before automatically following a non-unique numerical hint. Set to 0 (the default) to only follow numeric hints after pressing <Return> 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.
Note: Incremental searching currently only works in the forward direction.Use Insert mode as the default for text areas. This is useful if you want to use the known Swiftweasel interface for editing text areas. Input fields default to this behaviour irrespective of this option's setting.
Textarea mode can be entered with <C-t> from Insert mode.
Determines when the last window will have a status line.
Possible values:
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 vimperatorrc file has been sourced. To load plugins earlier, use the :loadplugins command within the vimperatorrc.
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:
Desired info in the :pageinfo output.
Available items:
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:
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.
Note: This option does not change the popup blocker of Swiftweasel in any way.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:
Example:
:set runtimepath=~/myvimperator,~/.vimperator
This will search for plugins in both ~/myvimperator/plugin and ~/.vimperator/plugin
On startup, if the environment variable $VIMPERATOR_RUNTIME does not exist, Vimperator will set it to match this value.
The default list of private items to sanitize.
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.
Note: This only applies to cookies, history, formdata, and downloads.Number of lines to scroll with <C-u> and <C-d> commands. The number of lines scrolled defaults to half the window size. When a [count] is specified to the <C-u> or <C-d> 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.
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 <Tab> are shown.
Possible values:
Control when to show the tab bar of opened web pages.
Possible values:
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.
Warning: This feature could make tab-completion slower because it needs to wait for changes, so use it only if you have a fast internet connection.Change the title of the browser window. Vimperator changes the browser title from Title of web page - Mozilla Swiftweasel to Title of web page - Vimperator. If you don't like that, you can restore it with:
:set titlestring=Mozilla Swiftweasel
Show current website with a minimal style sheet to make it easily accessible.
Note: This is a local option for now, a global value may be supported in the future.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, Vimperator 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:
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
Note: Unlike Vim each pattern is a regex rather than a glob.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:
A list of words that change how command-line completion is done.
Possible words:
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.