NAME

SYNOPSIS

DESCRIPTION

OPTIONS

-C, --cmd CMD

Run CMD as ex command line right before the first page is loaded. If the flag is used more than one time, the ordering is preserved when CMD are executed. You could also pass several ex commands in one CMD, if they are separated by "|".

Example:

vimb --cmd "set cookie-accept=origin|set header=Referer,DNT=1"
    

-c, --config CONFIG-FILE

Use custom configuration given as CONFIG-FILE. This will also be applied on new spawned instances.

-p, --profile PROFILE-NAME

Create or open specified configuration profile. Configuration data for the profile is stored in a directory named PROFILE-NAME under default directory for configuration data.

-e, --embed WINID

WINID of an XEmbed-aware application, that Vimb will use as its parent.

-d, --dump

Dump the current used socket path to stdout in case Vimb is started with -s option.

Example:

sh -c "./vimb -s -d > ~/vimb.socket" &
echo ":o github.com<CR>" | socat - unix-connect:$(< ~/vimb.socket)
    

-h, --help

Show help options.

-k, --kiosk

Run Vimb in kiosk mode with nearly no keybindings, not inputbox and no context menu.

-s, --socket

If given Vimb will create a control socket in the user runtime directory.

-v, --version

Print build and version information.

MODES

Normal Mode

The default mode. Pressing Escape always enter normal mode.

Input Mode

Used for editing text elements in a webpage.

Command Mode

Execute `ex` commands from the builtin inputbox (commandline).

Pass-Through Mode

In Pass-Through mode only the `<Esc>` and `<C-[>` keybindings are interpreted by Vimb, all other keystrokes are given to the webview to handle them. This allows the use of a website's configured keybindings, that might otherwise be swallowed by Vimb.

NORMAL MODE COMMANDS

General

:

Start Command Mode and print `:' to the input box.

gi

Set cursor to the first editable element in the page and switch to Input Mode.

CTRL-Z

Switch Vimb into Pass-Through Mode.

gf

Toggle show HTML source of the current page.

gF

Open the Web Inspector for the current page.

CTRL-V

Pass the next key press directly to GTK.

CTRL-Q

Quit the browser if there are no running downloads.

Navigation

o

Start Command Mode and print `:open ' to the input box.

O

Start Command Mode and print `:open URI' to the input box.

t

Start Command Mode and print `:tabopen ' to the input box.

T

Start Command Mode and print `:tabopen URI' to the input box.

gh

Open the configured home-page.

gH

Open the configured home-page in a new window.

u

Open the last closed page.

U

Open the last closed page in a new window.

CTRL-P

Open the oldest entry from the Read It Later queue in the current browser window (only if Vimb has been compiled with QUEUE feature).

["x]p

Open the URI out of the register x or, if not given, from the clipboard.

["x]P

Open the URI out of the register x or, if not given, from the clipboard in a new window.

[N]CTRL-O

Go back N steps in the browser history.

[N]CTRL-I

Go forward N steps in the browser history.

[N]gu

Go to the Nth descendent directory of the current opened URI.

gU

Go to the domain of the current opened page.

[N]CTRL-A

Increments the last number in URL by 1, or by N if given.

[N]CTRL-X

Decrements the last number in URL by 1, or by N if given. Negative numbers are not supported as trailing numbers in URLs are often preceded by hyphens.

r

Reload the website.

R

Reload the website without using caches.

CTRL-C

Stop loading the current page.

Motion

[N]CTRL-F

Scroll N pages down.

[N]CTRL-B

Scroll N pages up.

[N]CTRL-D

Scroll N half pages down.

[N]CTRL-U

Scroll N half pages up.

[N]gg

Scroll to the top of the current page. Or if N is given to N% of the page.

[N]G

Scroll to the bottom of the current page. Or if N is given to N% of the page.

0, ^

Scroll to the absolute left of the document. Unlike in Vim, 0 and ^ work exactly the same way.

$

Scroll to the absolute right of the document.

[N]h

Scroll N steps to the left of page.

[N]l

Scroll N steps to the right of page.

[N]j

Scroll page N steps down.

[N]k

Scroll page N steps up.

[N]]]

Follow the last Nth link matching `nextpattern'.

[N][[

Follow the last Nth link matching `previouspattern'.

m{a-z}

Set a page mark {a-z} at the current position on the page. Such set marks are only available on the current page; if the page is left, all marks will be removed.

'{a-z}

Jump to the mark {a-z} on the current page.

''

Jumps to the position before the latest jump, or where the last "m'" command was given.

Hinting

<CR>

Selects the first highlighted element, or the current focused.

<Tab>

Moves the focus to the next hint element.

<S-Tab>

Moves the focus to the previous hint element.

<Esc>, CTRL-C, CTRL-[

Exits Hints mode without selecting an element.

Hint modes:

Syntax: g;{mode}{hint}

Start an extended hints mode and stay there until <Esc> is pressed. Like normal hinting, except that after a hint is selected, hints remain visible so that another one can be selected with the same action as the first. Note that the extended hint mode can only be combined with the following hint modes I p P s t y Y.

Searching

/QUERY, ?QUERY

Start searching for QUERY in the current page. / start search forward, ? in backward direction.

*, #

Start searching for the current selected text, or if no text is selected for the content of the primary or secondary clipboard. * start the search in forward direction and # in backward direction.

Note that these commands will yank the text selection into the clipboard and may remove other content from there!

[N]n

Search for Nnth next search result depending on current search direction.

[N]N

Search for Nnth previous search result depending on current search direction.

<CR>

Perform a click on element containing the current highlighted search result.

Zooming

[N]zi

Zoom-In the text of the page by N steps.

[N]zo

Zoom-Out the text of the page by N steps.

[N]zI

Full-Content Zoom-In the page by N steps.

[N]zO

Full-Content Zoom-Out the page by N steps.

zz

Reset Zoom.

Yank

["x]y

Yank the URI or current page into register x and clipboard.

["x]Y

Yank the current selection into register x and clipboard.

COMMAND MODE

-

autocmd

-

cmap, cnoremap, imap, inoremap, nmap, nnoremap

-

eval

-

normal

-

open, tabopen

-

shellcmd

Command Line Editing

<Esc>, CTRL-[, CTRL-C

Ignore all typed content and switch back to normal mode.

<CR>

Submit the entered `ex` command or search query to run it.

CTRL-H

Deletes the char before the cursor.

CTRL-W

Deletes the last word before the cursor.

CTRL-U

Remove everything between cursor and prompt.

CTRL-B

Moves the cursor directly behind the prompt `:'.

CTRL-E

Moves the cursor after the char in inputbox.

CTRL-V

Pass the next key press directly to GTK.

CTRL-R {a-z"%:/;}

Insert the content of given register at cursor position. See also section about `:reg[ister]' command.

Command Line History

<Tab>

Start completion of the content in the inputbox in forward direction.

<S-Tab>

Start completion of the content in the inputbox in backward direction.

<Up>

Step backward in the command history.

<Down>

Step forward in the command history.

Open

:o[pen] [URI]

Open the give URI in the current window. If URI is empty, the configured 'home-page' is opened.

:t[abopen] [URI]

Open the give URI in a new window. If URI is empty, the configured 'home-page' is opened.

Key Mapping

n

Normal mode: when browsing normally.

i

Insert mode: when interacting with text fields on a website.

c

Command Line mode: when typing into Vimb's command line.

:nm[ap] {lhs} {rhs}

:im[ap] {lhs} {rhs}

:cm[ap] {lhs} {rhs}

Map the key sequence lhs to rhs for the modes where the map command applies. The result, including rhs, is then further scanned for mappings. This allows for nested and recursive use of mappings.

:nn[oremap] {lhs} {rhs}

:ino[remap] {lhs} {rhs}

:cno[remap] {lhs} {rhs}

Map the key sequence lhs to rhs for the mode where the map command applies. Disallow mapping of rhs, to avoid nested and recursive mappings. Often used to redefine a command.

:nu[nmap] {lhs}

:iu[nmap] {lhs}

:cu[nmap] {lhs}

Remove the mapping of lhs for the applicable mode.

Bookmarks

:bma [tags]

Save the current opened URI with tags to the bookmark file.

:bmr [URI]

Removes all bookmarks for given URI or, if not given, the current opened page.

Handlers

:handler-add handler=cmd

Adds a handler to direct handler links to the external cmd. The cmd can contain one placeholder `%s` that will be filled by the full URI given when the command is called.

:handler-remove handler

Remove the handler for the given URI handler.

Shortcuts

:shortcut-add shortcut=URI

Adds a shortcut with the shortcut and URI template. The URI can contain multiple placeholders $0-$9 that will be filled by the parameters given when the shortcut is called. The parameters given when the shortcut is called will be split into as many parameters like the highest used placeholder.

To use spaces within the parameters, the parameters can be grouped by surrounding them with single-or double quotes-as shown in example shortcut `map'.

:shortcut-remove shortcut

Remove the search engine to the given shortcut.

:shortcut-default shortcut

Set the shortcut for given shortcut as the default. It doesn't matter if the shortcut is already in use or not to be able to set it.

Settings

:se[t] var=value

Set configuration values named by var. To set boolean variable you should use 'on', 'off' or 'true' and 'false'. Colors are given as hexadecimal value like '#f57700'.

:se[t] var+=value

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.

:se[t] var^=value

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.

:se[t] var-=value

Subtract the value from a number option, or remove the value from a string option, if it is there. When the option is a comma separated list, a comma is deleted, unless the option becomes empty.

:se[t] var?

Show the current set value of variable. VAR.

:se[t] var!

Toggle the value of boolean variable var and display the new set value.

Queue

:qpu[sh] [URI]

Push URI or, if not given, the current URI to the end of the queue.

:qun[shift] [URI]

Push URI or, if not given, the current URI to the beginning of the queue.

:qp[op]

Open the oldest queue entry in the current browser window and remove it from the queue.

:qc[lear]

Removes all entries from queue.

Automatic commands

group

When the [group] argument is not given, Vimb uses the current group as defined with ':augroup', otherwise, Vimb uses the group defined with [ group]. Groups are useful to remove multiple grouped autocommands.

event

You can specify a comma separated list of event names. No white space can be used in this list.

pat

Comma separated list of patterns, matches in order to check if a autocommand applies to the URI associated to an event. To use ',' within the single patterns this must be escaped as '\,'.

cmd

Any `ex` command vimb understands. The leading ':' is not required. Multiple commands can be separated by '|'.

:au[tocmd] [group] {event} {pat} {cmd}

Add cmd to the list of commands that Vimb will execute automatically on event for a URI matching pat autocmd-patterns. Vimb always adds the cmd after existing autocommands, so that the autocommands are executed in the order in which they were given.

:au[tocmd]! [group] {event} {pat} {cmd}

Remove all autocommands associated with event and which pattern match pat, and add the command cmd. Note that the pattern is not matches literally to find autocommands to remove, like Vim does. Vimb matches the autocommand pattern with pat. If [ group] is not given, deletes autocommands in current group, as noted above.

:au[tocmd]! [group] {event} {pat}

Remove all autocommands associated with event and which pattern matches pat in given group (current group by default).

:au[tocmd]! [group] * {pat}

Remove all autocommands with patterns matching pat for all events in given group (current group by default).

:au[tocmd]! [group] {event}

Remove all autocommands for event in given group (current group by default).

:au[tocmd]! [group]

Remove all autocommands in given group (current group by default).

:aug[roup] {name}

Define the autocmd group name for the following ":autocmd" commands. The name "end" selects the default group.

:aug[roup]! {name}

Delete the autocmd group name.

:aug github
:  au LoadCommited * set scripts=off|set cookie-accept=never
:  au LoadCommited http{s,}://github.com/* set scripts=on
:aug end

Misc

:sh[ellcmd] cmd

Runs the given shell cmd syncron and print the output into inputbox. The following patterns in cmd are expanded: '~username', '~/', '$VAR' and '${VAR}'. A '\' before these patterns disables the expansion.

:sh ls -l $HOME

:sh[ellcmd]! cmd

Like :sh[ellcmd], but asyncron.

Example:

:sh! /bin/sh -c 'echo "`date` $VIMB_URI" >> myhistory.txt'
    

:s[ave] [path]

Download current opened page into configured download directory. If path is given, download under this file name or path. path is expanded and can therefore contain '~/', '${ENV}' and '~user' pattern.

:so[urce] [file]

Read ex commands from file.

:q[uit]

Close the browser. This will be refused if there are running downloads.

:q[uit]!

Close the browser independent from an running download.

:reg[ister]

Display the contents of all registers.

:e[val] javascript

Runs the given javascript in the current page and display the evaluated value.

Example: :eval document.cookie

:e[val]! javascript

Like :eval, but there is nothing print to the input box.

:no[rmal] [cmds]

Execute normal mode commands cmds. This makes it possible to execute normal mode commands typed on the input box.

cmds cannot start with a space. Put a count of 1 (one) before it, "1 " is one space.

Example: :set scripts!|no! R

:no[rmal]! [cmds]

Like :normal, but no mapping is applied to cmds.

:ha[rdcopy]

Print current document. Open a GUI dialog where you can select the printer, number of copies, orientation, etc.

INPUT MODE

<Esc>, CTRL-[

Switch back to normal mode.

CTRL-O

Executes the next command as normal mode command and return to input mode.

CTRL-T

Open configured $EDITOR with content of current form field.

CTRL-V

Pass the next key press directly to GTK.

CTRL-Z

Enter the pass-through mode.

COMPLETIONS

commands

The completion for commands are started when at least `:` is shown in the inputbox. If initial chars are passed, the completion will lookup those commands that begin with the given chars.

settings

The setting name completion is started if at least `:set ` is shown in inputbox and does also match settings that begins with already typed setting prefix.

history

The history of URIs is shown for the `:open ` and `:tabopen ` commands. This completion looks up every given word in the history URI and titles. Only those history items are shown, where the title or URI contains all tags.

Example:

bookmarks

The bookmark completion is similar to the history completion, but does match only the tags of the bookmarks. The bookmark completion is started by `:open !` or `:tabopen !` and does a prefix search for all given words in the bookmark tags.

Example:

boomark tags

The boomark tag completion allows the insertion of already used bookmarks for the `:bma ` commands.

search

The search completion allows a filtered list of already done searches. This completion starts by `/` or `?` in inputbox and performs a prefix comparison for further typed chars.

SETTINGS

WebKit-Settings

accelerated-compositing (bool)

Enable or disable support for accelerated compositing on pages. Accelerated compositing uses the GPU to render animations on pages smoothly and also allows proper rendering of 3D CSS transforms.

auto-load-images (bool)

Load images automatically.

auto-resize-window (bool)

Indicates if Vimb will honor size and position changes of the window by various DOM methods.

auto-shrink-images (bool)

Automatically shrink standalone images to fit.

caret (bool)

Whether to enable accessibility enhanced keyboard navigation.

closed-max-items (int)

Maximum number of stored last closed browser windows. If closed-max-items is set to 0, closed browser windows will not be stored.

cursivfont (string)

The font family used as the default for content using cursive font.

defaultencoding (string)

The default text charset used when interpreting content with an unspecified charset.

defaultfont (string)

The font family to use as the default for content that does not specify a font.

dns-prefetching (bool)

Indicates if Vimb prefetches domain names.

dom-paste (bool)

Whether to enable DOM paste. If set to TRUE, document.execCommand("Paste") will correctly execute and paste content of the clipboard.

file-access-from-file-uris (bool)

Boolean property to control file access for file:// URIs. If this option is enabled every file:// will have its own security unique domain.

fontsize (int)

The default font size used to display text.

frame-flattening (bool)

Whether to enable the Frame Flattening. With this setting each subframe is expanded to its contents, which will flatten all the frames to become one scrollable page.

html5-database (bool)

Whether to enable HTML5 client-side SQL database support. Client-side SQL database allows web pages to store structured data and be able to use SQL to manipulate that data asynchronously.

html5-local-storage (bool)

Whether to enable HTML5 localStorage support. localStorage provides simple synchronous storage access.

hyperlink-auditing (bool)

Enable or disable support for <a ping>.

images (bool)

Determines whether images should be automatically loaded or not.

insecure-content-show (bool)

Whether pages loaded via HTTPS should load subresources such as images and frames from non-HTTPS URIs. Only for webkit>=2.0.

insecure-content-run (bool)

Whether pages loaded via HTTPS should run subresources such as CSS, scripts, and plugins from non-HTTPS URIs. Only for webkit>=2.0.

java-applet (bool)

Enable or disable support for the Java <applet> tag. Keep in mind that Java content can be still shown in the page through <object> or <embed>, which are the preferred tags for this task.

javascript-can-access-clipboard (bool)

Whether JavaScript can access the clipboard.

javascript-can-open-windows-automatically (bool)

Whether JavaScript can open popup windows automatically without user intervention.

media-playback-allows-inline (bool)

Whether media playback is full-screen only or inline playback is allowed. Setting it to false allows specifying that media playback should be always fullscreen.

media-playback-requires-user-gesture (bool)

Whether a user gesture (such as clicking the play button) would be required to start media playback or load media. Setting it on requires a gesture by the user to start playback, or to load the media.

media-stream (bool)

Enable or disable support for MediaSource on pages. MediaSource is an experimental proposal which extends HTMLMediaElement to allow JavaScript to generate media streams for playback.

mediasource (bool)

Enable or disable support for MediaSource on pages. MediaSource is an experimental proposal which extends HTMLMediaElement to allow JavaScript to generate media streams for playback.

minimumfontsize (int)

The minimum font size used to display text.

monofont (string)

The font family used as the default for content using monospace font.

monofontsize (int)

Default font size for the monospace font.

offlinecache (bool)

Whether to enable HTML5 offline web application cache support. Offline web application cache allows web applications to run even when the user is not connected to the network.

pagecache (bool)

Enable or disable the page cache. Disabling the page cache is generally only useful for special circumstances like low-memory scenarios or special purpose applications like static HTML viewers.

print-backgrounds (bool)

Whether background images should be printed.

private-browsing (bool)

Whether to enable private browsing mode. This suppresses printing of messages into JavaScript Console. At the time this is the only way to force WebKit to not allow a page to store data in the windows sessionStorage.

plugins (bool)

Determines whether or not plugins on the page are enabled.

print-backgrounds (bool)

Whether background images should be drawn during printing.

resizable-text-areas (bool)

Whether text areas are resizable.

respect-image-orientation (bool)

Whether Vimb should respect image orientation.

sansfont (string)

The font family used as the default for content using sans-serif font.

scripts (bool)

Determines whether or not JavaScript executes within a page.

seriffont (string)

The font family used as the default for content using serif font.

site-specific-quirks (bool)

Enables the site-specific compatibility workarounds.

smooth-scrolling (bool)

Enable or disable support for smooth scrolling.

spacial-navigation (bool)

Whether to enable the Spatial Navigation. This feature consists in the ability to navigate between focusable elements in a Web page, such as hyperlinks and form controls, by using Left, Right, Up and Down arrow keys. For example, if a user presses the Right key, heuristics determine whether there is an element they might be trying to reach towards the right, and if there are multiple elements, which element they probably want.

spell-checking (bool)

Whether to enable spell checking while typing.

spell-checking-languages (string)

The languages to be used for spell checking, separated by commas.

The locale string typically is in the form lang_COUNTRY, where lang is an ISO-639 language code, and COUNTRY is an ISO-3166 country code. For instance, sv_FI for Swedish as written in Finland or pt_BR for Portuguese as written in Brazil.

If no value is specified the default value for GTK is used.

tab-key-cycles-through-elements (bool)

Whether the Tab key cycles through elements on the page.

If true, pressing the Tab key will focus the next element in the web view. Otherwise, the web view will interpret Tab key presses as normal key presses. If the selected element is editable, the Tab key will cause the insertion of a Tab character.

universal-access-from-file-uris (bool)

Whether to allow files loaded through file:// URIs universal access to all pages.

useragent (string)

The user-agent string used by WebKit.

webaudio (bool)

Enable or disable support for WebAudio on pages. WebAudio is an experimental proposal for allowing web pages to generate Audio WAVE data from JavaScript.

webgl (bool)

Enable or disable support for WebGL on pages.

webinspector (bool)

Determines whether or not developer tools, such as the Web Inspector, are enabled.

xssauditor (bool)

Whether to enable the XSS auditor. This feature filters some kinds of reflective XSS attacks on vulnerable web sites.

Vimb-Settings

auto-response-header (list)

Prepend HTTP-Header to responses received from server, based on pattern matching. The purpose of this setting is to enforce some security setting in the client. For example, you could set Content-Security-Policy (see `http://www.w3.org/TR/CSP/') for implement a whitelist policy, or set Strict-Transport-Security for server that don't provide this header whereas they propose https website.

Note that this setting will not replace existing headers, but add a new one. If multiple patterns match a requested URI, the last matched rule will be applied. You could also specified differents headers for the same pattern.

The format is a list of `pattern header-list`. If `header-list` has not than one element, enclosing with QUOTE is mandatory: `"pattern header-list"`. The header-list format is the same as `header` setting.

ca-bundle (string)

The path to the .crt file for the certificate validation. The given path is expanded with standard file expansion.

completion-bg-active (color)

Background color for selected completion item.

completion-bg-normal (color)

Background color for non-selected completion items.

completion-fg-active (color)

Foreground color for the selected completion item.

completion-fg-normal (color)

Foreground color for the non-selected completion items.

completion-font (string)

Font used for the completion items.

cookie-accept (string)

Cookie accept policy {`always', `never', `origin' (accept all non-third-party cookies)}.

cookie-timeout (int)

Cookie timeout in seconds.

cookie-expire-time (int)

Enforce expire-time on cookies. The default value `-1' keep expire-time as defined by server side. The value `0' convert all cookies as session-only cookies (`cookie-timeout' setting is used as for any other session-cookie). Any other value enforce the expire-time (the expire-time value will be the lower between server-side request and time defined with `cookie-expire-time').

default-zoom (int)

Initial Full-Content Zoom in percent. Default is 100.

download-command (string)

A command with placeholder '%s' that will be invoked to download a URI.

download-path (string)

Path to the default download directory. If the directory is not set download will be written into current directory. The following pattern will be expanded if the download is started '~/', '~user', '$VAR' and '${VAR}'.

download-use-external (bool)

Indicates if the external download tool set as `download-command' should be used to handle downloads. If this is disabled Vimb will handle the download.

editor-command (string)

Command with placeholder '%s' called if form filler is opened with $EDITOR to spawn the editor-like `x-terminal-emulator -e vi %s'. To use Gvim as the editor, it's necessary to call it with `-f' to run it in the foreground.

fullscreen (bool)

Show the current window full-screen.

header (list)

Comma separated list of headers that replaces default header sent by WebKit or new headers. The format for the header list elements is `name[=[value]]'.

Note that these headers will replace already existing headers. If there is no '=' after the header name, then the complete header will be removed from the request, if the '=' is present means that the header value is set to empty value.

To use '=' within a header value the value must be quoted like shown in Example for the Cookie header.

hint-follow-last (bool)

If on, vimb automatically follows the last remaining hint on the page. If off hints are fired only if enter is pressed.

hint-number-same-length (bool)

If on, all hint numbers will have the same length, so no hints will be ambiguous.

hint-timeout (int)

Timeout before automatically following a non-unique numerical hint. To disable auto fire of hints, set this value to 0.

hintkeys (string)

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. Note that the hint matching by label built of hintkeys is case sensitive. In this vimb differs from some other browsers that show hint labels in upper case, but match them lowercase.

history-max-items (int)

Maximum number of unique items stored in search-, command or URI history. If history-max-items is set to 0, the history file will not be changed.

home-page (string)

Homepage that vimb opens if started without a URI.

hsts (bool)

Enable or disables the HSTS (HTTP Strict Transport Security) feature.

input-autohide (bool)

If enabled the inputbox will be hidden whenever it contains no text.

input-bg-error (color)

Background color for the inputbox if error is shown.

input-bg-normal (color)

Background color of the inputbox.

input-fg-error (color)

Foreground color of inputbox if error is shown.

input-fg-normal (color)

Foreground color of inputbox.

input-font-error (string)

Font user in inputbox if error is shown.

input-font-normal (string)

Font used for inputbox.

nextpattern (list)

Patterns to use when guessing the next page in a document. Each pattern is successively tested against each link in the page beginning from the last link. Default "/\bnext\b/i,/^(>|>>|»)$/,/^(>|>>|»)/,/(>|>>|»)$/,/\bmore\b/i". Note that you have to escape the '|' as '\|' else the '|' will terminate the :set command and start a new command.

maximum-cache-size (int)

Size in kB used to cache various page data. This caching is independent from `pagecache' or `offlinecache'. To disable caching, the size could be set to '0'.

previouspattern (list)

Patterns to use when guessing the previous page in a document. Each pattern is successively tested against each link in the page beginning from the last link. Default "/\bnext\b/i,/^(>|>>|»)$/,/^(>|>>|»)/,/(>|>>|»)$/,/\bmore\b/i"

proxy (bool)

Indicates if the environment variable `http_proxy' is evaluated.

scrollstep (int)

Number of pixel vimb scrolls if 'j' or 'k' is used.

statusbar (bool)

Indicates if the statusbar should be shown.

status-color-bg (color)

Background color of the statusbar.

status-color-fg (color)

Foreground color of the statusbar.

status-font (string)

Font used in statusbar.

status-ssl-color-bg (color)

Background color of statusbar if current page uses trusted https certificate.

status-ssl-color-fg (color)

Foreground color for statusbar for https pages.

status-ssl-font (string)

Statusbar font for https pages.

status-sslinvalid-color-bg (color)

Background color of the statusbar if the certificate if the https page isn't trusted.

status-sslinvalid-color-fg (color)

Foreground of statusbar for untrusted https pages.

status-sslinvalid-font (string)

Statusbar font for untrusted https pages.

strict-focus (bool)

Vimb checks if an editable element is focused and switch to input mode. If strict-focus is enabled, this isn't done for focused element on page load (without user interaction), instead the focus is removed from the focused element. Focus changed that appear after the page was completely loaded are not affected by this setting.

strict-ssl (bool)

If 'on', vimb will not load a untrusted https site.

stylesheet (bool)

If 'on' the user defined styles-sheet is used.

timeoutlen (int)

The time in milliseconds that is waited for a key code or mapped key sequence to complete.

x-hint-command (string)

Command used if hint mode ;x is fired. The command can be any vimb command string. Note that the command is run through the mapping mechanism of vimb so it might change the behaviour by adding or changing mappings.

FILES

$XDG_CONFIG_HOME/vimb/

Default directory for configuration data.

$XDG_CONFIG_HOME/vimb/PROFILE-NAME

Directory for configuration data if executed with -p PROFILE-NAME parameter. It has same structure as default directory for configuration data.

$XDG_CACHE_HOME/vimb/

Default directory for cache data.

$XDG_CACHE_HOME/vimb/PROFILE-NAME

Directory for cache data if executed with -p PROFILE-NAME parameter.

$XDG_RUNTIME_DIR/vimb/socket/

Directory where the control sockets are placed.

$XDG_RUNTIME_DIR/vimb/PROFILE-NAME/socket/

Directory where the control sockets are placed if executed with -p PROFILE-NAME parameter.

ENVIRONMENT

http_proxy

If this variable is set to an non-empty value, and the configuration option `proxy' is enabled, this will be used as HTTP proxy. If the proxy URL has no scheme set, HTTP is assumed.

no_proxy

A comma separated list of domains and/or IPs which should not be proxied. Note that an IPv6 address must appear in brackets if used with a port, for example "[::1]:443".

Example: "localhost,127.0.0.1,::1,fc00::/7,example.com:8080"

REPORTING BUGS

AUTHOR