sodcalculator

10 Tech How-To

Vim Style Browser Navigation: Setup Guide

Guide 10-57344 · Updated · Step by step

This guide shows you how to add Vim-style keyboard navigation to your browser, letting you move the cursor, scroll, open links, and switch tabs without touching the mouse. You’ll need a modern browser (Chrome, Firefox, Edge, or Safari) and a few minutes to install and configure an extension.

What You’ll Need

  • A desktop browser: Chrome, Firefox, Edge, or Safari (mobile browsers don’t support these extensions well).
  • Permission to install browser extensions (admin rights on your computer may be required).
  • Basic comfort with keyboard shortcuts—no prior Vim experience is necessary.

Step-by-Step

  1. Choose an extension. The most popular options are Vimium (Chrome/Edge/Firefox) and Vim Vixen (Firefox). For Safari, try Vimari. This guide uses Vimium as the reference, but the steps are similar for others.
  2. Install the extension. Go to your browser’s extension store (Chrome Web Store, Firefox Add-ons, etc.), search for the extension name, and click “Add to Browser” (or “Install”). Confirm any permission prompts—they are needed for the extension to read page content.
  3. Open the extension’s options page. Click the extension’s icon in your toolbar (usually a small V or keyboard symbol) and select “Options” or “Settings.” Alternatively, you can type chrome://extensions (or about:addons in Firefox), find the extension, and click “Details” then “Extension options.”
  4. Review the default key mappings. The default keys are already Vim-like: j/k to scroll down/up, h/l to move left/right, f to open a link, gg/G to go to top/bottom, and d/u to scroll half a page. You can use these immediately.
  5. Customize the mappings (optional but recommended). In the options page, you’ll see a text area with the current configuration. Each line maps a key to an action, e.g., map j scrollDown. To change a key, edit the line. To add a new mapping, type map [key] [action]. For example, map scrollPageDown makes Ctrl+D scroll down a full page. After editing, click “Save” (or the changes auto-save).
  6. Set your preferred scroll behavior. Look for options like “Scroll duration” (how long the scroll animation takes) and “Smooth scroll” (enable/disable). Set these to your liking—shorter durations feel snappier.
  7. Configure excluded sites. Some sites (like Google Docs or Gmail) have their own keyboard shortcuts that conflict. In the options, find the “Excluded URLs” field and add patterns like https://docs.google.com/* to disable Vimium there. This prevents accidental interference.
  8. Test the setup. Close the options page and go to any website. Press j to scroll down, k to scroll up, and f to see link hints (small letters appear on links; type the letter to open it). Try H and L to go back/forward in history.
  9. Learn the help page. Press ? (Shift+/) on any page to open the extension’s help overlay, which lists all available commands. Bookmark this page for reference.
  10. Adjust as you go. After a few days, you’ll notice which keys feel awkward. Reopen the options and remap them. For example, many users change d (scroll half page) to c-d (Ctrl+D) to avoid accidental presses.

Common Mistakes

  • Not saving changes. Some extensions require you to click a “Save” button before closing options. If your mappings don’t work, reopen options and look for an unsaved changes indicator.
  • Conflicting with browser shortcuts. For example, t usually opens a new tab in the browser, but Vimium may remap it to something else. Check your browser’s own shortcuts and avoid overlapping.
  • Using uppercase when you meant lowercase. In Vimium, J and j are different actions. Ensure you’re pressing the correct case.
  • Forgetting to exclude sites. On sites like YouTube, the spacebar is used to play/pause. If you don’t exclude it, Vimium might scroll instead. Add exclusions proactively.
  • Expecting it to work in PDFs or embedded frames. Extensions often cannot access PDF viewers or cross-origin iframes. You’ll need to use your mouse there.

Tips

  • Use link hints for everything. The f key is the most powerful feature. You can press F (capital) to open a link in a new tab. This replaces right-clicking and middle-clicking.
  • Memorize the top 10 keys first. Don’t try to learn all commands at once. Start with j, k, f, gg, G, d, u, H, L, and r (reload).
  • Use the find function. Press / to search within a page (like Vim’s search). Type your query and press Enter; press n to go to the next match, N for previous.
  • Customize to your muscle memory. If you’re a touch typist, you might prefer e for scroll up instead of k. There’s no right or wrong—just what feels natural.
  • Use the Vomnibar. Press o to open a command bar that lets you search bookmarks, history, or type a URL. This is faster than using the address bar.

Troubleshooting

  • Extension not working on a page. First, check if the page is in your excluded list. If not, try refreshing the page. Some single-page apps (like Gmail) need a reload after the extension is installed.
  • Keys do nothing. Open the extension’s help (press ?) to see if the extension is active. If the help doesn’t open, the extension may be disabled. Go to your browser’s extension manager and ensure it’s enabled.
  • Keys conflict with the site. For example, on GitHub, t opens a file finder. If you want Vimium to override the site, you can add the site to your “Excluded URLs” and then use Vimium’s “Insert mode” (press i) to temporarily disable Vimium on that page.
  • Link hints don’t appear. Some pages use custom scrolling containers (like chat apps). Try pressing f again after clicking on the page. If it still fails, the extension may not support that page’s structure.
  • Scroll is too fast/slow. Adjust the “Scroll duration” in options. A lower value (e.g., 100ms) makes scrolling instant, while a higher value (e.g., 500ms) gives a smooth glide.
  • After an update, settings reset. Extensions occasionally reset to defaults after a major update. Export your configuration (if available) or keep a backup of your custom mappings in a text file.

Frequently Asked Questions

  1. Will this work on all websites? No. Some sites block keyboard events or use complex layouts. You can exclude those sites or use insert mode (i) to temporarily disable Vimium.
  2. Can I use Vimium on Firefox? Yes, Vimium is available for Firefox. However, some features may be limited due to Firefox’s extension API differences. Vim Vixen is a good alternative.
  3. Is it safe to install? These extensions are open-source and widely used. They request permissions to read and modify page content, which is necessary for their function. Always download from official stores.
  4. How do I open a link in a new tab? Press F (capital F) to activate link hints, then type the letter. The link opens in a new background tab. To open in a new foreground tab, press Alt+F (or the key combination shown in the help).
  5. Can I use these shortcuts in the browser’s new tab page? Usually yes, but some new tab pages are special. If it doesn’t work, just navigate to any website and test there.
  6. What if I forget a key? Press ? to bring up the help overlay. It lists all commands and their current keybindings. You can also search online for the official documentation.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →