The hacker's browser.
Switch branches/tags
Nothing to show
Pull request Compare This branch is 3679 commits behind philc:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
test_harnesses
CREDITS
MIT-LICENSE.txt
README.markdown
background_page.html
commands.js
helpDialog.html
linkHints.js
manifest.json
options.html
vimiumFrontend.js

README.markdown

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

You'd like to fix a bug or implement a feature? Great! Check out the bugs on our issues tracker, or implement one of the suggestions there that have been tagged 'todo'. If you have a suggestion of your own, start a discussion on the issues tracker or on the mailing list. If it mirrors a similar feature in another browser or in Vim itself, let us know! Once you've picked something to work on, add a comment to the respective issue so others don't duplicate your effort.

When you're done, send us a pull request on Github. Feel free to include a change to the CREDITS file with your patch.

Release Notes

1.18

  • Run on pages with file:/// and ftp:///
  • The Options page is now linked from the Help dialog.
  • Bug fixes.

1.17 (04/18/2010)

  • 'u' now restores tabs that were closed by the mouse or with native shortcuts. Tabs are also restored in their prior position.
  • New 'unmapAll' command in the key mappings interface to remove all default mappings.
  • Link hints are now faster and more reliable.
  • 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.