Just like Vim, moving through a webpage can be done by entering commands by the keyboard. Most of these commands require just one or two keystrokes.
Vimprobable mimics the ex-commandmode of Vim. By entering a colon (:) commands like open, set and map can be entered.
Don't want to read this entire manpage? Here are a few basic steps:
o Insert URL from keyboard and load it
t Insert URL from keyboard and load it into new window
j Scroll down
k Scroll up
d Close current window
These commands are used to walk through the browse-history.
r Reload
<shift>R Force reload
c Cancel load
zi Zoom text in
zI Zoom full content in
zo Zoom text out
zO Zoom full content out
zz Zoom reset
zZ Zoom reset
y Yank current URL into clipboard
Y Yank current selection into clipboard
gu Load URL one directory up
gu Load rootdirectory of current URL
gh Load homepage
gH Load homepage into new window
p Load URL from clipboard
P Load URL from clipboard into new window
o Insert URL from keyboard and load it
t Insert URL from keyboard and load it into new window
u Open a new window with the URL which was closed last
/ Start search
? Start backward search
n Next search result
f (or ;o) Follow link
F (or ;t or ;w) Follow link in new window
;s Save the specified link (or element) to disk
;y Yank the destination's location
;O Generate an :open command with the link's URL (like O)
;T or ;W Generate an :tabopen command with the link's URL (like T)
;i Open image in current window
;I Open image in new window
gi Focus next input field
The following commands are entered after first entering a colon (:)
Insert URL from keyboard and load it
Shortcut: o
Insert URL from keyboard and load it into new window
Shortcut: t
Bookmarks the current page.
Bookmarks are retrieved by tabcompletion when entering a new URL.
You can add tags to the bookmarks by just adding words after the command, e.g.
:bma tag1 tag2 tag3
Open all bookmarks containing a certain tag in new windows.
The commands :fo, :forward, :ba and :backward move through the browse-history
The commands :re, :reload, ;re! and :reload! are given to reload or force reload.
Cancel current loading
Toggles between normal view and sourcecode view.
Change default settings on the fly. See man vimprobablerc for the list of settings to be changed.
Change default keybindings on the fly. See man vimprobablerc for the list of mappings to be changed.
Close current window
Shortcut: d
Print the current URL
Vimprobable is a modal browser. By default, it is in command mode, meaning that any keystroke will be interpreted by the internal command engine. INSERT mode is automatically activated if an input field on a website becomes focused. Should this not work (due to limitations of the Webkit-GTK engine and the faulty HTML code of some websites, this is possible), you can manually switch the browser to PASSTHROUGH mode instead (Ctrl+Z). In INSERT and PASSTHROUGH modes, keystrokes will not be interpreted by the browser, but passed to the underlying engine/website.
In addition, there is HINT mode. This is activated with the "f" key by default. Enter a the number of a link to follow it. Alternatively, you can enter the link text (case sensitive) to narrow down your choices.
Up to 9 quickmarks can be defined. These are stored as quickmark 1 up to quickmark 9. You can store the URI of the current page as quickmark with
:set qmark=<hotkey>
Later you can recall the quickmark with
q<hotkey>
Example:
:set qmark=4 Store current URI as quickmark 4
q4 Recall quickmark 4
Searchengines let you submit queries to web search engines and similar sites without having to type the complete URL or visit the page first.
For example, if ex is defined as the shortcut for the search at example.com, you can use "ex search term" instead of an URL to search there for "search term".
The following search engines (and shortcuts) are already defined in config.h:
You can always overwrite them or define your own in $HOME/.config/vimprobable/vimprobablerc. See vimprobablerc (5) for details. Default search engine
If Vimprobable doesn't recognize an address as a valid URL or query to one of the defined search engines, it will use the default search engine instead. See vimprobablerc(5) on how to set this default.
You can define external applications to handle requests for defined URI schemas.
The following URI handlers are already defined in config.h:
See vimprobablerc(5) for details how to add or override these settings.
You can always overwrite them or define your own in $HOME/.config/vimprobable/vimprobablerc.
Please make sure you create these files before first running the browser. Everything but the history, bookmarks and closed files is optional. The cookies file is required if you want to use cookies.
$HOME/.config/vimprobable/vimprobablerc
$HOME/.config/vimprobable/bookmarks
$HOME/.config/vimprobable/cookies
$HOME/.config/vimprobable/history
$HOME/.config/vimprobable/closed
$HOME/.config/vimprobable/quickmarks
$HOME/.config/vimprobable/style.css