Keyboard Shortcuts extension for Safari
Vimarily (pronounced like 'primarily') is a Safari extension that provides vim style keyboard based navigation. This lets you control Safari from your keyboard instead of having to use your mouse to open links, scroll, etc.
Vimarily is a fork of Vimari which is heavily based on vimium, a Chrome extension that provides much more extensive features.
- Download the latest version of Vimarily
- Unzip it
- Move it to your
/Applicationsfolder - Launch Vimarily.app
- Click "Open in Safari Extensions Preferences...", Safari's Extension Preferences should open
- Make sure that the checkbox for the Vimarily extension is ticked
- Go back to Vimarily.app and press the reload button to check the status of the app. If it says "Enabled" then it is ready.
- You may need to relaunch Safari for the extension to work
Modifier - Modifier key to hold down with your action key. If you leave it blank you don't need to hold down anything (default setting).
Excluded URLs - Comma separated list of website URLs you don't want
to use Vimarily with. To exclude GitHub for example, provide the value
github.com or http://github.com. It's smart and should handle all
possible domain cases.
Link Hint Characters - Allowed characters to be used when generating link shortcuts.
Extra detection by cursor style - Detect clickable links by looking for HTML elements having cursor style set to "pointer".
Scroll Size - How much each scroll will move on the page.
Smooth Scroll - Scroll smoothly through the page.
Normal vs Insert mode - Isolate website keybindings from the Vimarily keybindings. In normal mode you can use the Vimarily keybindings while in insert mode you can use the websites own keybindings.
Transparent Bindings - Full keybinding isolation might not be your style, instead the transparent bindings setting (when enabled) allows you to use all non-Vimarily-bound keys to interact with the web page as if you were in insert mode.
Vimarily is built as a Safari Extension, this poses some limits on what is possible through the extension. However default Safari shortcuts can help you keep your hands at the keyboard. Some helpful ones are listed here:
-
Focus URL Bar ⌘l - This is a feature not available in Vimarily, it is also helpful where extensions are not loaded (for example on
topsites://). By focusing the URL Bar you can go to a website where the extension is loaded. -
Reader mode ⇧⌘R - Currently Vimarily does not support entering Reader mode (due to API limitations), also navigation inside reader mode (for example using j or k) is not supported.
-
Re-open last closed tab ⇧⌘T - Allows you to reopen a recently closed tab.
Copyright (C) 2022 Marc Donald. See LICENSE for details.
Copyright (c) 2010 Phil Crosby, Ilya Sukhar. See VIMARI_LICENSE for details.