README.md

   1 # VimFx - Vim keyboard shortcuts for Firefox
   2
   3 ![VimFx Logo](https://raw.github.com/akhodakivskiy/VimFx/develop/icon-large.png)
   4
   5 **Extension AMO page**: https://addons.mozilla.org/en-US/firefox/addon/vimfx.
   6
   7 **Mailing list**: [vimfx@librelist.com](mailto:vimfx@librelist.com?subject=Subscribe) (just send an email to subscribe)
   8
   9 Contribute your localization! See `locale` folder.
  10
  11 Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening issues and pull requests.
  12
  13 ## Overview
  14
  15 [VimFx](https://addons.mozilla.org/en-US/firefox/addon/vimfx/)
  16 is a [Mozilla Firefox](https://www.mozilla.org/en-US/firefox/fx/#desktop)
  17 extension which introduces Vim-style keyboard shortcuts for browsing and navigation,
  18 significantly reducing the use of mouse, and allowing your hands to rest on the home row.
  19
  20 VimFx was inspired by [Vimperator](http://www.vimperator.org/)
  21 and designed after [Vimium](http://vimium.github.com/) for
  22 [Google Chrome](https://www.google.com/intl/en/chrome/browser/) preserving the shortcuts and behavior.
  23 If you are used to Vimium then it will be easy to get started with VimFx.
  24
  25 ## Why VimFx was created
  26
  27 Even before Vimium there was Vimperator for Firefox.  In my opinion the problem
  28 with Vimperator is that it has too many features and aggressively changes
  29 the default Firefox appearance and behavior. Vimium was developed for Google Chrome
  30 and it was exactly what I needed in terms of added functionality. That's why I decided
  31 to develop similar extension for Firefox.
  32
  33 VimFx will be nice to your browser and to your habits. Promise.
  34
  35 ## Key Features
  36
  37 - Concise shortcuts for most commonly performed actions
  38 - Follow and access controls on the page using hint markers
  39 - Easy access to the keyboard shortcuts dialog, which describes and lets you customize all available shortcuts (press ?)
  40
  41 ## Shortcuts
  42
  43 This is a text representation of the keyboard shortcuts dialog within the extension. Might not be up to date.
  44 Press ? or use the toolbar button to open the dialog, which helps you remember the shortcuts, and lets you customize them.
  45
  46 Global shortcut to enable/disable VimFx: `shift-alt-v`
  47
  48 ### Dealing with URLs
  49
  50     o       Focus the Address Bar
  51     O       Focus the Search Bar
  52     p       Navigate to the address in the clipboard
  53     P       Open new tab and navigate to the address in the clipboard
  54     yf      Copy link url to the clipboard
  55     vf      Focus element
  56     yy      Copy current page link to the clipboard
  57     r       Reload current page
  58     R       Reload current page and all the assets (js, css, etc.)
  59     ar      Reload pages in all tabs
  60     aR      Reload pages in all tabs including assets (js, css, img)
  61     s       Stop loading current page
  62     as      Stop loading pages in all tabs
  63
  64 ### Navigating the Page
  65
  66     gg      Scroll to the Top of the page
  67     G       Scroll to the Bottom of the page
  68     j,c-e   Scroll Down
  69     k,c-y   Scroll Up
  70     h       Scroll Left
  71     l       Scroll Right
  72     d       Scroll half a Page Down
  73     u       Scroll half a Page Up
  74     c-f     Scroll full Page Down
  75     c-b     Scroll full Page Up
  76
  77 ### Working with Tabs
  78
  79     t       Open New Blank tab
  80     J,gT    Go to the Previous tab
  81     K,gt    Go to the Next tab
  82     c-J     Move current tab to the Left
  83     c-K     Move current tab to the Right
  84     gh      Navigate to the Home Page
  85     gH,g^   Go to the First tab
  86     gL,g$   Go to the Last tab
  87     gp      Pin/Unpin current tab
  88     yt      Duplicate current tab
  89     gx$     Close tabs to the right
  90     gxa     Close other tabs except the current tab
  91     x       Close current tab
  92     X       Restore last closed tab
  93
  94 ### Browsing
  95
  96     f       Follow a link on the current page
  97     F       Follow a link on the current page in a new tab
  98     af      Follow multiple links on the current page
  99     [       Follow the Previous page link on the current page
 100     ]       Follow the Next page link on the current page
 101     gu      Go up one level in the URL hierarchy
 102     gU      Go up to root of the URL hierarchy
 103     H       Go Back in history
 104     L       Go Forward in history
 105
 106 ### Misc
 107
 108     /       Enter Find mode
 109     a/      Enter Find mode to highlight all matches
 110     n       Go to the next Find match
 111     N       Go to the previous Find match
 112     i       Enter insert mode: Ignore all commands
 113     ?       Show this dialog
 114     :       Open Developer Toolbar
 115     Esc     Enter normal mode (remove hint markers, exit insert mode) or blur/close active element
 116
 117 Can't see a link hint, because it's overlapped by another? Try pressing space or shift-space!