Vimium C Options

Vimium C Options
Excluded URLs and keys		Wholly or partially disable Vimium C. A "`Pattern`" is a JS regular expression if it starts with "`^`", or "`:`" + the header of a URL. Otherwise it will be converted. If "`Keys`" is empty, Vimium C gets wholly disabled; if "`Keys`" starts with "`^`", only listed keys are enabled, and all others are passed through; otherwise, just the listed keys are passed through.
Custom key mappings	The related option "Ignore keyboard layout" is enabled	Remap keys and commands. Some examples: `map <f1> LinkHints.activate unmap <a-s-f> mapKey <a-e> <esc> shortcut createTab position="end" shortcut userCustomized1 command="goBack" # "unmapAll" unmaps all above and default` Show available commands. Auto resize. How to map keys in another keyboard layout? Global shortcuts are on chrome://extensions/…. More?
Characters used for link hints	The related option "Use link name" is enabled; Delete all to reset this option.	The characters placed next to each link after typing "f" to enter link-hint mode.
Default search engine	Delete all to reset this option.	Used when no search engine (or "`~`") matched.
Custom search engines	Delete all to reset this option.	Define search engines to build URLs. Format: `a\|A\|MainName: https://a.com/?q=%s js\:\|JS: javascript:\ $S; Run JavaScript key: https://c.com/$s/space=\s\ space_end # this is a comment` `$s` will be replaced with real queries. Auto resize . How to write advanced search engine rules?
Advanced Options
Scroll step size	px	The size for basic long movements (short = * 0.6).
Miscellaneous options
	In link-hint mode, this option lets you select a link by typing its text. Wiki.
		You activate the link with "Enter", always; so you never accidentally type Vimium commands.
		Prevent pages from focusing an input in loading (e.g. Google, Bing, etc.).
	Focus web page when creating a new tab (deprecated)	This option has been removed since the published v1.77.0. It can be replaced by extensions like NewTab Adapter.
		If partially checked, Vimium C will only ignore CapsLock on macOS.
		Always recognize keys in en-US QWERTY layout and ignore CapsLock, for some non-Latin keyboards.
		Switch back to plain find mode by the "`\R`" escape sequence.
		When enabled, the HUD will not be displayed in insert mode, just like a parameter of `hideHUD=true`.
		Follow your system's dark mode. Affect link hints, Vomnibar and inner blank page.
		Affect some animation of HUD and Vomnibar.
		Make it reflect working states on a current page. If this is unchecked, Vimium C will be a little faster.

		Need to reload Vimium C manually.
	Show the dialogue mode of this options page	The "Options" link on chrome://extensions will open a dialogue. This will only work since Chrome 40.
New tab URL	Delete all to reset this option.	"`pages/blank.html`" for a blank page. Since v1.77.0, Vimium C doesn't manage browser new tab any more. How to redirect to another extension's newtab?
Previous patterns	Delete all to reset this option.	The "navigate to previous page" command uses these patterns to find the link to follow (ignore case).
Next patterns	Delete all to reset this option.	The "navigate to next page" command uses these patterns to find the link to follow (ignore case).
Custom CSS for Vimium C UI		To style Vimium C nodes, use selectors such as "`.S`" and "`.LH > .MC`". These styles work in addition to and take precedence over Vimium C's default styles. Auto resize.
Vomnibar settings	Delete all to reset this option.	Adjust some inner behaviors of Vomnibar: "`maxMatches`" should be in `3 ~ 25` ; "`queryInterval`" should be in `0 ~ 1200` (unit: ms) ; "`size`" is to calculate Vomnibar's height; "`styles`" may be "`dark`" & "`mono-url`" . A low `queryInterval` will cause CPU cost a bit higher.
Block list of words for Vomnibar		For a bookmark / history item, if its title or URL contains any word or phrase in this list, it will not be listed on Vomnibar or the browser omnibox. One piece per line; no trimming; case-sensitive. "`#`" at the beginning means comments.
Allow list of other extension IDs	Delete all to reset this option.	Only extensions in this list are allowed to request Vimium C's support. One extension id per line. Any line the first char of which is neither a letter nor a number or "`_`" will be ignored. Auto resize. How to inject Vimium C into other extensions?
Preferred Vomnibar Page	Delete all to reset this option.	For example: `chrome-extension://cglpcedifkgalfdklahhcchnjepcckfn/vomnibar.html` or `https://gdh1995.cn/vomnibar.html` .
Locale encoding		In order to recognize URLs not encoded by `utf-8` . The default `gbk` is for Chinese.
Keyboard settings	Delete all to reset this option.	Your keyboard delay settings on this computer. Format: `[<delay>, <repeat period>]` (unit: ms). Note: this option will never be synchronized.

Excluded URLs
and keys

Wholly or partially disable Vimium C. A "Pattern" is a JS regular expression if it starts with "^", or ":" + the header of a URL. Otherwise it will be converted.
If "Keys" is empty, Vimium C gets wholly disabled;
if "Keys" starts with "^", only listed keys are enabled,
and all others are passed through;
otherwise, just the listed keys are passed through.

Custom key
mappings

The related option "Ignore keyboard layout" is enabled

Remap keys and commands. Some examples:


          map <f1> LinkHints.activate
unmap <a-s-f>
mapKey <a-e> <esc> 
shortcut createTab position="end"
shortcut userCustomized1 command="goBack"
# "unmapAll" unmaps all above and default

Show available commands. Auto resize.
How to map keys in another keyboard layout?
Global shortcuts are on chrome://extensions/…. More?

Characters used
for link hints

The related option "Use link name" is enabled; Delete all to reset this option.

The characters placed next to each link after typing "f" to enter link-hint mode.

Default search
engine

Delete all to reset this option.

Used when no search engine (or "~") matched.

Custom search
engines

Delete all to reset this option.

Define search engines to build URLs. Format:


          a|A|MainName: https://a.com/?q=%s
js\:|JS: javascript:\ $S; Run JavaScript
key: https://c.com/$s/space=\s\ space_end
# this is a comment

$s will be replaced with real queries. Auto resize .
How to write advanced search engine rules?

Scroll step size

The size for basic long movements (short = * 0.6).

Miscellaneous
options

In link-hint mode, this option lets you select a link by typing its text. Wiki.

Prevent pages from focusing an input in loading (e.g. Google, Bing, etc.).

If partially checked, Vimium C will only ignore CapsLock on macOS.

Always recognize keys in en-US QWERTY layout and ignore CapsLock, for some non-Latin keyboards.

Switch back to plain find mode by the "\R" escape sequence.

When enabled, the HUD will not be displayed in insert mode, just like a parameter of `hideHUD=true`.

Follow your system's dark mode. Affect link hints, Vomnibar and inner blank page.

Affect some animation of HUD and Vomnibar.

Make it reflect working states on a current page.
If this is unchecked, Vimium C will be a little faster.

Need to reload Vimium C manually.

New tab URL

Delete all to reset this option.

"pages/blank.html" for a blank page. Since v1.77.0, Vimium C doesn't manage browser new tab any more.
How to redirect to another extension's newtab?

Previous patterns

Delete all to reset this option.

The "navigate to previous page" command uses these patterns to find the link to follow (ignore case).

Next patterns

Delete all to reset this option.

The "navigate to next page" command uses these patterns to find the link to follow (ignore case).

Custom CSS
for Vimium C UI

To style Vimium C nodes, use selectors such as ".S" and ".LH > .MC".
These styles work in addition to and take precedence over Vimium C's default styles. Auto resize.

Vomnibar settings

Delete all to reset this option.

Adjust some inner behaviors of Vomnibar:

"maxMatches" should be in 3 ~ 25 ;
"queryInterval" should be in 0 ~ 1200 (unit: ms) ;
"size" is to calculate Vomnibar's height;
"styles" may be "dark" & "mono-url" .

A low queryInterval will cause CPU cost a bit higher.

Block list of words
for Vomnibar

For a bookmark / history item, if its title or URL contains any word or phrase in this list, it will not be listed on Vomnibar or the browser omnibox.

One piece per line; no trimming; case-sensitive.

"#" at the beginning means comments.

Allow list of other
extension IDs

Delete all to reset this option.

Only extensions in this list are allowed to request Vimium C's support. One extension id per line.

Any line the first char of which is neither a letter nor a number or "_" will be ignored. Auto resize.
How to inject Vimium C into other extensions?

Preferred
Vomnibar Page

Delete all to reset this option.

For example: chrome-extension://cglpcedifkgalfdklahhcchnjepcckfn/vomnibar.html or https://gdh1995.cn/vomnibar.html .

Locale encoding

In order to recognize URLs not encoded by utf-8 .
The default gbk is for Chinese.

Keyboard settings

Delete all to reset this option.

Your keyboard delay settings on this computer.

Format: [<delay>, <repeat period>] (unit: ms).
Note: this option will never be synchronized.