1 .\" Process this file with
2 .\" groff -man -Tascii vimprobable2.1
4 .TH VIMPROBABLE2 1 "JANUARY 2013" "Linux User Manuals"
6 Vimprobable \- A WWW browser based on webkit with keybindings inspired by Vim, the great editor.
13 .OP \fL\-v|\-\-version
19 Use the specified config file. If none found, defaults to
20 .I $HOME/.config/vimprobable/vimprobablerc
23 Given the windowid of an XEmbed-aware application, Vimprobable will use that as its parent.
26 Prints out a short usage summary.
29 Prints the version of Vimprobable.
32 Vimprobable is a WWW browser that is built around the webkit library. Vimprobable is fast.
33 Vimprobable comes without buttons and other graphic widgets. It is aimed at being controlled
34 as mouselessly as possible. It uses keybindings that are inspired by Vim, the great editor.
36 Just like Vim, moving through a webpage can be done by entering commands at the keyboard.
37 Most of these commands require just one or two keystrokes.
39 Vimprobable mimics the ex-command mode of Vim. By entering a colon (:) commands like open,
40 set and map can be entered.
44 Don't want to read this entire manpage? Here are a few basic steps:
47 Insert URL from keyboard and load it
50 Insert URL from keyboard and load it into new window
62 The default keyboard bindings are explained in this section. These keybindings
63 can be changed - either by the map command (changes will take effect immediately)
66 (changes in effect for each new window) or editing
68 in the source directory (in which case you will need to recompile to see changes take effect).
70 .IP "Move through current page"
71 Vimprobable recognizes the following motion commands:
72 0, $, g, <shift>G, h, j, k, l, Ctrl-b, Ctrl-f, Ctrl-d, Ctrl-u, Ctrl-e, Ctrl-y
74 .IP "Move through pages"
75 These commands are used to walk through the browse-history.
76 Ctrl-i, Ctrl-o, <shift>H, <shift>L
79 .IP "Reloading and cancel loading"
102 Zoom full content out
113 Yank current URL into clipboard
116 Yank current selection into clipboard
119 Load URL one directory up
122 Load rootdirectory of current URL
128 Load homepage into new window
131 Load URL from clipboard
134 Load URL from clipboard into new window
137 Insert URL from keyboard and load it
140 Insert URL from keyboard and load it into new window
143 Generate :open command with the current URL
146 Generate :tabopen command with the current URL
149 Open a new window with the URL which was closed last
158 Start backward search
164 Previous search result
172 .I " " F (or ;t or ;w)
173 Follow link in new window
176 Save the specified link (or element) to disk
179 Yank the destination's location
182 Generate an :open command with the link's URL (like O)
185 Generate an :tabopen command with the link's URL (like T)
188 Open image in current window
191 Open image in new window
194 Focus next input field
199 The following commands are entered after first entering a colon (:)
203 Insert URL from keyboard and load it
209 Insert URL from keyboard and load it into new window
213 .IP ":bma or :bookmark"
215 Bookmarks the current page.
217 Bookmarks are retrieved by tab completion when entering a new URL.
219 You can add tags to the bookmarks by entering tag terms after the command, e.g.
225 Open all bookmarks containing a certain tag in new windows.
227 .IP ":fo[rward] and :ba[ck]"
229 The commands :fo, :forward, :ba and :backward move through the browse-history
231 .IP ":re[load], :re! and :reload!"
233 The commands :re, :reload, ;re! and :reload! are given to reload or
238 Cancel current loading
242 Toggles between normal view and sourcecode view.
247 Change default settings on the fly. See
249 for the list of settings to be changed.
253 Change default keybindings on the fly. See
255 for the list of mappings to be changed.
265 Print the current URL
285 Vimprobable is a modal browser. By default, it is in command mode, meaning that
286 any keystroke will be interpreted by the internal command engine. INSERT mode
287 is automatically activated if an input field on a website becomes focused.
288 Should this not work (due to limitations of the Webkit-GTK engine and the faulty
289 HTML code of some websites, this is possible), you can manually switch the
290 browser to PASSTHROUGH mode instead (Ctrl+Z). In INSERT and PASSTHROUGH modes,
291 keystrokes will not be interpreted by the browser, but passed to the underlying
294 In addition, there is HINT mode. This is activated with the "f" key by default.
295 Enter a the number of a link to follow it. Alternatively, you can enter the
296 link text (case sensitive) to narrow down your choices.
300 Up to 9 quickmarks can be defined. These are stored as quickmark 1 up to
301 quickmark 9. You can store the URI of the current
302 page as quickmark with
304 .I :set qmark=<hotkey>
306 Later you can recall the quickmark with
313 Store current URI as quickmark 4
320 Searchengines let you submit queries to web search engines and similar sites
321 without having to type the complete URL or visit the page first.
325 is defined as the shortcut for the search at example.com, you can use "ex
326 search term" instead of an URL to search there for "search term".
328 The following search engines (and shortcuts) are already defined in config.h:
331 http://ixquick.com/do/metasearch.pl?query=%s
333 https://secure.wikimedia.org/wikipedia/en/w/index.php?title=Special%%3ASearch&search=%s&go=Go
335 https://secure.wikimedia.org/wikipedia/de/w/index.php?title=Special%%3ASearch&search=%s&go=Go
337 https://duckduckgo.com/?q=%s&t=Vimprobable
339 https://duckduckgo.com/html/?q=%s&t=Vimprobable
343 You can always overwrite them or define your own in
344 .I $HOME/.config/vimprobable/vimprobablerc.
345 See vimprobablerc (5) for details.
346 .B Default search engine
348 If Vimprobable doesn't recognize an address as a valid URL or query to one of the
349 defined search engines, it will use the default search engine instead. See
350 .BR vimprobablerc (5)
351 on how to set this default.
355 You can define external applications to handle requests for defined URI schemas.
357 The following URI handlers are already defined in config.h:
360 x-terminal-emulator -e wget %s
362 x-terminal-emulator -e mutt %s
364 x-terminal-emulator -e vi %s
369 .BR vimprobablerc (5)
370 for details how to add or override these settings.
372 You can always overwrite them or define your own in
373 .I $HOME/.config/vimprobable/vimprobablerc.
375 The vimprobableedit protocol plays a special role. It is used by
376 vimprobable when an external editor is called from within a text field.
377 Note that vimprobable will update the text field when the forked process
378 terminates. Editors that detach from the controlling terminal (vim -g
379 does, for example) terminate immediately as far as vimprobable is
380 concerned, which means your changes will not be pulled into the text
381 field. If your editor suffers from that disease, check of options that
382 keep it from detaching; for vim, the -f option does this.
386 Please make sure you create these files before first running the browser.
387 Everything but the history, bookmarks and closed files is optional. The cookies
388 file is required if you want to use cookies.
390 .I $HOME/.config/vimprobable/vimprobablerc
392 .I $HOME/.config/vimprobable/bookmarks
394 .I $HOME/.config/vimprobable/cookies
396 .I $HOME/.config/vimprobable/history
398 .I $HOME/.config/vimprobable/closed
400 .I $HOME/.config/vimprobable/quickmarks
402 .I $HOME/.config/vimprobable/style.css
406 There has not been any significant bug-hunting yet.
408 Hannes Schueller and Matto Fransen
410 .BR vimprobablerc (5),