Vimprobable - browser based on Vim editor

[oui]

VIMPROBABLE2

Section: User Commands (1)
Updated: JANUARY 2013
Index Return to Main Contents

NAME

Vimprobable - A WWW browser based on webkit with keybindings inspired by Vim, the great editor.


SYNOPSIS

vimprobable2 [ -c|--config ] [ -e|--embed ] [ -h|--help ] [ -v|--version ] [ URI ]


OPTIONS

-c config file
Use the specified config file. If none found, defaults to $HOME/.config/vimprobable/vimprobablerc
-e windowid
Given the windowid of an XEmbed-aware application, Vimprobable will use that as its parent.
-h
Prints out a short usage summary.
-v
Prints the version of Vimprobable.

DESCRIPTION

Vimprobable is a WWW browser that is built around the webkit library. Vimprobable is fast. Vimprobable comes without buttons and other graphic widgets. It is aimed at being controlled as mouselessly as possible. It uses keybindings that are inspired by Vim, the great editor.
Just like Vim, moving through a webpage can be done by entering commands at the keyboard. Most of these commands require just one or two keystrokes.

Vimprobable mimics the ex-command mode of Vim. By entering a colon (:) commands like open, set and map can be entered.



QUICK START

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



KEYBOARD BINDINGS

The default keyboard bindings are explained in this section. These keybindings can be changed - either by the map command (changes will take effect immediately) or by altering vimprobablerc (changes in effect for each new window) or editing keymap.h in the source directory (in which case you will need to recompile to see changes take effect).
Move through current page
Vimprobable recognizes the following motion commands: 0, $, g, <shift>G, h, j, k, l, Ctrl-b, Ctrl-f, Ctrl-d, Ctrl-u, Ctrl-e, Ctrl-y
Move through pages
These commands are used to walk through the browse-history. Ctrl-i, Ctrl-o, <shift>H, <shift>L
Reloading and cancel loading
r Reload

<shift>R Force reload

Ctrl-c Cancel load

Zoom in and out
zi Zoom text in

zI Zoom full content in

zo Zoom text out

zO Zoom full content out

zz Zoom reset

zZ Zoom reset

URL commands
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

O Generate :open command with the current URL

T Generate :tabopen command with the current URL

u Open a new window with the URL which was closed last

Search
/ Start search

? Start backward search

n Next search result

N Previous search result

Hinting
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


COLON COMMANDS

The following commands are entered after first entering a colon (:)

:open
Insert URL from keyboard and load it

Shortcut: o

:tabopen
Insert URL from keyboard and load it into new window

Shortcut: t

:bma or :bookmark
Bookmarks the current page.

Bookmarks are retrieved by tab completion when entering a new URL.

You can add tags to the bookmarks by entering tag terms after the command, e.g.

:bma tag1 tag2 tag3

:qt
Open all bookmarks containing a certain tag in new windows.

:fo[rward] and :ba[ck]
The commands :fo, :forward, :ba and :backward move through the browse-history

:re[load], :re! and :reload!
The commands :re, :reload, ;re! and :reload! are given to reload or force reload.

:st[op]
Cancel current loading

:source
Toggles between normal view and sourcecode view.

:set
Change default settings on the fly. See man vimprobablerc for the list of settings to be changed.

:map
Change default keybindings on the fly. See man vimprobablerc for the list of mappings to be changed.

:quit
Close current window

Shortcut: d

:print
Print the current URL

:zi
Zooms text in

:zo
Zooms text out

:pgzi
Zooms page in

:pgzo
Zooms page out


MODES

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.



QUICKMARKS

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

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:

i
http://ixquick.com/do/metasearch.pl?query=%s
w
https://secure.wikimedia.org/wikipedia/ ... h=%s&go=Go
wd
https://secure.wikimedia.org/wikipedia/ ... h=%s&go=Go
d
https://duckduckgo.com/?q=%s&t=Vimprobable
dd
https://duckduckgo.com/html/?q=%s&t=Vimprobable
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.



URI HANDLERS

You can define external applications to handle requests for defined URI schemas.

The following URI handlers are already defined in config.h:

ftp://
x-terminal-emulator -e wget %s
mailto:
x-terminal-emulator -e mutt %s
vimprobableedit:
x-terminal-emulator -e vi %s
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.

The vimprobableedit protocol plays a special role. It is used by vimprobable when an external editor is called from within a text field. Note that vimprobable will update the text field when the forked process terminates. Editors that detach from the controlling terminal (vim -g does, for example) terminate immediately as far as vimprobable is concerned, which means your changes will not be pulled into the text field. If your editor suffers from that disease, check of options that keep it from detaching; for vim, the -f option does this.



FILES

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



BUGS

There has not been any significant bug-hunting yet.
AUTHORS

Hannes Schueller and Matto Fransen
SEE ALSO

vimprobablerc(5),

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
QUICK START
KEYBOARD BINDINGS
COLON COMMANDS
MODES
QUICKMARKS
SEARCHENGINES
URI HANDLERS
FILES
BUGS
AUTHORS
SEE ALSO
This document was created by man2html, using the manual pages.
Time: 12:20:08 GMT, May 17, 2013

[oui]

VIMPROBABLERC

Section: File Formats (5)
Updated: JANUARY 2014
Index Return to Main Contents

NAME

vimprobablerc - The configuration file for Vimprobable
DESCRIPTION

If you have a .config/vimprobable/vimprobablerc in your home directory, Vimprobable will read it at startup.
The vimprobablerc file consists of a series of configuration options, one per line. Blank lines and lines starting with a colon (:) are seen as comments and will be ignored.

FILES

$HOME/.config/vimprobable/vimprobablerc
Per user configuration file.

FORMAT

set
set is used to alter a default setting. For possible options that can be altered, see the SETTINGS section below.
Each line looks like this:

set what=value

Vimprobable is not picky about white space in these lines.

map
map is used to change the default key-binding. For possible options that can be altered see the MAPPING section below.
Each line looks like this:

map what=value

Vimprobable is not picky about white space in these lines.

misc
Any command listed under colon commands in vimprobable2(1) will be accepted in the config file as well.

FORMAT MODIFIED KEYS

It is possible to map keys modified with eiter Control or Modkeys. To map a key modified with Control, use this format: <C-h> where C stands for the Control-key and h for the h-key. <M1-j> maps the combination of Mod1 and the j-key. Mod1 is usually the "Alt" key, Mod4 the "Windows" key.

Examples: <C-h> : Ctrl-h <C-k> : Ctrl-k z<M1-i>: z followed by Alt-i



SETTINGS

This section describes the possible options that can be changed from their default value.

completioncase=[true|false]
Case sensitive (true) or insensitive tab completion.
homepage=URL
Set the URL of the homepage.
useragent=<useragent-string>
Replace the default useragent-string.
acceptlanguage=<acceptlanguage-string>
Replace the default acceptlanguage-string.
scripts=[true|false]
Enable or disable scripts.
plugins=[true|false]
Enable or disable plugins.
java=[true|false]
Enable or disable Java applets.
images=[true|false]
Enable or disable autoload of images.
shrinkimages=[true|false]
Enable or disable autoshrink of images.
completionfontnormal=font
Font used in the tab completion list.
completionfonterror=font
Font used in the tab completion list for errors.
cursivefont=cursivefont-family
Replace the default cursive font family
defaultencoding=encoding
Replace the default encoding
defaultfont=default-font-family
Replace the default font family
defaultsearch=searchengine-shortcut
Replace the default search engine
downloadspath=/path/to/downloaded/files
Absolute path on the local file system to download files to (default: $HOME)
escapeinput=[true|false]
Ignore automatic focusing of input elements by websites on load.
fontsize=integer
Replace the default fontsize
monofontsize=integer
Replace the default monospace fontsize
caret=[true|false]
Enable or disable caret browsing
fantasyfont=fantasy-font-family
Replace the default fantasy font family
minimumfontsize=integer
Replace the default minimum font size
monofont=default-monospace-font-family
Replace the default monospace font family
pagecache=[true|false]
Enable or disable webkit's internal page cache
proxy=[true|false]
Whether to read and use the http_proxy environment variable
backgrounds=[true|false]
Enable or disable print backgrounds
sansfont=default-sans-font-family
Replace the default sans-serif font family
scrollbars=[true|false]
Enable or disable scrollbars.
statusbar=[true|false]
Show or hide the status bar.
statusfont=font
Dont used in the status bar.
inputbox=[true|false]
Show or hide the input box.
seriffont=default-serif-font-family
Replace the default serif font family
stylesheet=URL
Replace the user stylesheet
urlboxfontnormal=font
Font used in the URL box.
urlboxfontwarning=font
Font used in the URL box for warnings.
urlboxfonterror=font
Font used in the URL box for errors.
webinspector=[true|false]
Enable or disable webinspector
strictssl=[true|false]
Reject or accept unverified certificates (default: true)
cabundle=/path/to/file
Where CA certificates are stored (default: /etc/ssl/certs/ca-certificates.crt)
tempdir=/path/without/slash
A path to a directory for temporary files (default: $TMPDIR or /tmp)

MAPPINGS

Keys can be mapped to the following functions:

quit
Close the browser
stop
Stop the current loading process
bookmark
Save the current website in the bookmarks
source
Toggle HTML source view
inspect
Opens the webinspector if the webinspector is enabled
jumpleft
Scroll to left edge
jumpright
Scroll to right edge
jumptop
Scroll to top of the page
jumpbottom
Scroll to bottom of the page
pageup
Scroll one screensize up
pagedown
Scroll one screensize down
navigationback
Go to previous page in browser-history
navigationforward
Go to next page in browser-history
reload
Reload current page
scrollleft
Scroll the page one step to the left
scrollright
Scroll the page one step to the right
scrollup
Scroll the page one step up
scrolldown
Scroll the page one step down
openeditor
When in a text box, open the external editor
Example: To map the 'R' key to reload to current page, add the following line into ~/.config/vimprobable/vimprobablerc:

map R reload


MAPPING KEYS TO COLON COMMANDS

Key can be mapped to any colon commands. Instead of entering an internal symbol for the key combination to be mapped to, enter a command line as you would enter it within a running browser instance. For example:

map <C-s>=:set scripts=false

This would map Control-s to disable Javascript.

map i=:javascript console.log('insertmode_on')

This maps the i key to manually activate INSERT mode.



MAPPING COMMANDS TO EXISTING COMMANDS

You can create new commands by mapping them to an already working command line. For example:

map :bmatag1=:bookmark tag1

would create a new command "bmatag1" which would bookmark the current page and automatically add "tag1" to it.



INTERACTIVE SETTING

All settings can be changed on the fly by entering :set followed by one of the commands in the SETTINGS section above.


SHORTCUTS (SEARCH ENGINES)

You can define new shortcuts or override the pre-defined ones using the following format (without the angle brackets):

shortcut <shortcut> <URL with at most one %s>
where the %s serves as a placeholder for the term to be inserted into the URL. Other percent signs in the URL have to be escaped as %%. Using the shortcut feature without %s will simply work as shorthand to much-used bookmarks.



URI HANDLERS

You can define external applications to handle requests for defined URI schemas using the following syntax (without the angle brackets):

handler <URI schema> <handler command with exactly one %s>
where the %s serves as a placeholder for the rest of the URI.



BUGS

There has not been any significant bug-hunting yet.
AUTHORS

Hannes Schueller and Matto Fransen
SEE ALSO

vimprobable2(1),

Index

NAME
DESCRIPTION
FILES
FORMAT
FORMAT MODIFIED KEYS
SETTINGS
MAPPINGS
MAPPING KEYS TO COLON COMMANDS
MAPPING COMMANDS TO EXISTING COMMANDS
INTERACTIVE SETTING
SHORTCUTS (SEARCH ENGINES)
URI HANDLERS
BUGS
AUTHORS
SEE ALSO
This document was created by man2html, using the manual pages.
Time: 11:21:54 GMT, January 01, 2014

[oui]

install it with the puppy puppy package manager

(applications > setup >> puppy package manager)

[Colonel Panic]

Thanks for this one, it looks interesting and I might give it a try later. There used to be a browser called Vimperator which was based on Firefox and also used the Vim command set, but I don't know what happened to that one.

[unicorn316386]

Vimprobable does not seem to be part of slackware 14.1 in PPM here, only available for 64-bit I guess?

Since it uses webkit, does it also have the problems you mentioned here?
http://www.murga-linux.com/puppy/viewtopic.php?p=873088#873088

Maybe Vimperator (mentioned by Colonel Panic) based off Firefox will work better

[oui]

following screen view shows the package you need to download!

to find them, inform you for ex. at:

Ubuntu testet neues Paketformat - Pro-Linux
http://www.pro-linux.de/news/1/22264/ub ... ormat.html
Debian -- Package Search Results -- libidl0
https://packages.debian.org/search?keywords=libidl0
Ubuntu 14.04: Nützliche Software, Updates, PPAs | Privatstrand
http://privatstrand.dirkschmidtke.de/20 ... ates-ppas/
Debian Package Tracking System - mhwaveedit
https://packages.qa.debian.org/m/mhwaveedit.html
Debian Package Tracker - mhwaveedit
https://tracker.debian.org/pkg/mhwaveedit
Index of /ubuntu/pool/universe/m
http://archive.ubuntu.com/ubuntu/pool/universe/m/

(text above: extract of my /root/.xombrero/favorites)