knuton / vimium

The hacker's browser.

Vimium - The Hacker's Browser

Vimium is a Chrome extension that provides keyboard based navigation and control in the spirit of the Vim editor.

Installation instructions:

You can install the stable version of Vimium from the Chrome Extensions Gallery.

Alternatively, you can install it from source:

1. Navigate to chrome://extensions
2. Click on "Load Extension..."
3. Select the vimium directory.

The Settings page can be found by clicking the Options button next to Vimium on chrome://extensions.

Keyboard Bindings

Modifier keys are specified as follows: , , for ctrl+x, meta+x, and alt+x respectively.

Navigating the current page: h scroll left j scroll down k scroll up l scroll right gg scroll to top of the page G scroll to bottom of the page , scroll down a page , scroll up a page scroll down a full page scroll up a full page f activate link hints mode to open in current tab F activate link hints mode to open in new tab r reload gf view source zi zoom in zo zoom out / enter find mode -- type your search query and hit enter to search or esc to cancel n cycle forward to the next find match N cycle backward to the previous find match i enter insert mode -- all commands will be ignored until you hit esc to exit y copy the current url to the clipboard

Navigating your history: H go back in history L go forward in history

Manipulating tabs: J, gT go one tab left K, gt go one tab right t create tab d close current tab u restore closed tab (i.e. unwind the 'd' command)

Vimium supports command repetition so, for example, hitting '5t' will open 5 tabs in rapid succession. ESC (or <c-[>) will clear any partial commands in the queue.

Keys can be unmapped and remapped to different commands under Advanced Options.

Contributing

Send us a pull request on Github with some explanation. If the patch adds new behavior or functionality, please let us know whether it mirrors a similar extension for another browser or Vim itself. Feel free to include a change to the CREDITS file with your patch.

Release Notes

1.17 (Unreleased)

• 'u' now restores tabs that were closed by the mouse or with native shortcuts. Tabs are also restored in their prior position.
• Bug fixes.

1.16 (03/09/2010)

• Add support for configurable key mappings under Advanced Options.
• A help dialog which shows all currently bound keyboard shortcuts. Type "?" to see it.
• Bug fixes related to key stroke handling.

1.15 (01/31/2010)

• Make the CSS used by the link hints configurable. It's under Advanced Options.
• Add a notification linking to the changelog when Vimium is updated in the background.
• Link-hinting performance improvements and bugfixes.
• Ctrl+D and Ctrl+U now scroll by 1/2 page instead of a fixed amount, to mirror Vim's behavior.

1.14 (01/21/2010)

• Fixed a bug introduced in 1.13 that prevented excluded URLs from being saved.

1.13 (01/21/2010)

• and are now mapped to scroll a full page up or down respectively.
• Bugfixes related to entering insert mode when the page first loads, and when focusing Flash embeds.
• Added command listing to the Options page for easy reference.
• J & K have reversed for tab switching: J goes left and K goes right.
• <c-[> is now equivalent to ESC, to match the behavior of VIM.
• & are now mapped to scroll down and up respectively.
• The characters used for link hints are now configurable under Advanced Options.

1.11, 1.12 (01/08/2010)

• Commands 'gt' & 'gT' to move to the next & previous tab.
• Command 'yy' to yank (copy) the current tab's url to the clipboard.
• Better Linux support.
• Fix for Shift+F link hints.
• ESC now clears the keyQueue. So, for example, hitting 'g', 'ESC', 'g' will no longer scroll the page.

1.1 (01/03/2010)

• A nicer looking settings page.
• An exclusion list that allows you to define URL patterns for which Vimium will be disabled (e.g. http*://mail.google.com/*).
• Vimium-interpreted keystrokes are no longer sent to the page.
• Better Windows support.
• Various miscellaneous bug fixes and UI improvements.

License

Copyright (c) 2010 Phil Crosby, Ilya Sukhar. See MIT-LICENSE.txt for details.