#What is cVim?

Vim for Google Chrome. I hate using the mouse, especially after learning Vim. With my desktop (Linux), I have a lot of key bindings that make doing things easier: I open Chrome with Alt+w, I close a window with Alt+Shift+d, I open a terminal with Alt+t. This is harder to do with Chrome because it has no section for customizing keyboard shortcuts, and it is still necessary to use the mouse to do things like click links. cVim aims to eliminate this problem as best as the Chrome extensions API will allow it to.

#Where can I get cVim?

• There are two ways:
• You can install it through the Chrome web store
• You can download the .zip file here and enable cVim by going to the chrome://extensions URL and checking developer mode, then pointing Chrome to the unzipped folder via the Load unpacked extensions... button.

These extensions do a wonderful job of adding Vim-like keybindings to Google Chrome, but they lack many of the features that Firefox Addon, Pentadactyl, have.

• What features does cVim add to Chrome?
• Google/IMDB/Wikipedia/Amazon/Duckduckgo/Yahoo/Bing search completion
• Support for custom search engines
• History and Bookmark search/completion with bookmark folder support
• Caret/Visual mode
• Efficient link hints (with support for custom mappings)
• Support for custom keyboard mappings
• Regex page search with highlighting
• Command bar with tab-completion
• Smooth scrolling

#cVim Help ###cVimrc

• Boolean cVimrc settings are enabled with the command 'set' + <SETTING_NAME> and disabled with the command 'set' + no<SETTING_NAME> (for example, set regexp and set noregexp)
• Boolean cVimrc settings can be inversed by adding "!" to the end
• Other settings are defined with = used as a separator and are prefixed by let (for example, let hintcharacters="abc")

###Example configuration

" Settings
set nohud
set nosmoothscroll
set noautofocus "The opposite of autofocus; this setting stops sites from focusing on an input box when they load
set typelinkhints
let searchlimit = 30
let scrollstep = 70
let barposition = "bottom"
let locale = "uk" "Current choices are 'jp' and 'uk'. This allows cVim to use sites like google.co.uk or google.co.jp to search rather than google.com. Support is currently very limited. Let me know if you need a different locale for one of the completion/search engines
let hintcharacters = "abc123"
let searchengine dogpile = "http://www.dogpile.com/search/web?q=%s" "If you leave out the '%s' at the end of the URL, your query will be appended to the link. Otherwise, your query will replace the '%s'.
let completionengines = ["google", "amazon", "imdb", "dogpile"]
let searchalias g = "google" "Create a shortcut for search engines. For example, typing ':tabnew g example' would act the same way as ':tabnew google example'
let qmark a = ["http://www.reddit.com", "http://www.google.com", "http://twitter.com"]  "Open all of these in a tab with `gnb` or open one of these with <N>goa where <N>
let blacklists = ["https://mail.google.com/*", "*://*.reddit.com/*"]
let mapleader = ","

" Mappings

map <Leader>r reloadTabUncached
map <Leader>x :restore<Space>

map j scrollUp "This remaps the default 'j' mapping
map gb :buffer<Space> "You can use <Space>, which is interpreted as a literal " " character, to enter buffer completion mode
unmap k "The unmaps the default 'k' mapping

map f F "This remaps the default 'f' mapping to the current 'F' mapping

map <C-h> :set hud!<CR> "Toggle the current HUD display value
map <C-i> :set numerichints!<CR> "Switch between alphabetical hint characters and numeric hints
map <C-u> rootFrame
map <M-h> previousTab
map <C-d> scrollPageDown
map <C-e> scrollPageUp
iunmap <C-y>
imap <C-m> deleteWord
map X :execute gTx<CR> "Close the current tab and move to the one before it

###Blacklists

• You can blacklist specific commands on chosen domains by adding the keybinding after the blacklist URL. For instance, if you want smooth scrolling enabled with the <Up> and <Down> keys, but not on pages like Chrome's built-in PDF viewer (in which the up and down keys won't respond if they have been mapped), your cVimrc would look like this:

map <Up> scrollUp
map <Down> scrollDown

and the blacklists setting would have look like this:

let blacklists = ["*://*/*.pdf <Up> <Down>"]

• The blacklists setting uses a custom inplementation of Chrome's @match pattern guidelines. See https://developer.chrome.com/extensions/match_patterns for a description of the syntax.

###Mappings

• Normal mappings are defined with the following structure: map <KEY> <MAPPING_NAME>
• Insert mappings use the same structure, but use the command "imap" instead of "map"
• Control, meta, and alt can be used also:

<C-u> "Ctrl + u
<M-u> "Meta + u
<A-u> "Alt  + u

• It is also possible to unmap default bindings with unmap <KEY> and insert bindings with iunmap <KEY>
• To unmap all default keybindings, use unmapAll. To unmap all default insert bindings, use iunmapAll

###Tabs

• Commands that open links (:tabnew and :open) have three different properties
• ! => Open in a new tab
• & => Open in a new tab (inactive/unfocused)
• * => Pin the tab
• The use of these properties are best explained with examples:

:open! google<CR> "This is the same as :tabnew google<CR>
:open google!<CR> "This is another way of writing the above (these flags can can be added to either the base command or the end of the final command)

:open& google<CR> "This will open Google in a new inactive tab

:open&* google<CR> "The will open Google in a new inactive, pinned tab
:tabnew google&*<CR> "Once again, this will do the same thing as the above command
:open google&*<CR> "Again, same as above

:open google!& "Here, the & flag will cancel out the ! flag, opening Google in a new inactive tab

"More examples
:bookmarks my_bookmark.com& "inactive,new tab
:bookmarks&* my_bookmark.com "inactive,pinned,new tab
:bookmarks! my_bookmark.com "new tab
:bookmarks my_bookmark.com "same tab

#Keybindings

#Command Mode

#Tips

• You can use @% in "open" commands to specify the current URL. For example, ":open @%" would essentially refresh the current page.
• Prepend a number to the command to repeat that command N times
• Use the up/down arrows in command/find mode to navigate through previously executed commands/searches -- you can also use this to search for previously executed commands starting with a certain combination of letters (for example, entering "ta" in the command bar and pressing the up arrow will search command history for all matches beginning with "ta"