XXXTERM(1) OpenBSD Reference Manual XXXTERM(1)
NAME
xxxterm - lightweight web browser with vi key bindings
SYNOPSIS
xxxterm [-STtV] [-f file] [uri ...]
DESCRIPTION
xxxterm is a minimalistic web browser that tries to stay out of the way
so that valuable screen real estate can be used for much more important
stuff. It has sane defaults and does not require one to learn a language
to do any configuration. It was written by hackers for hackers and it
strives to be small, compact and fast.
When xxxterm starts up, it reads settings from its configuration file,
xxxterm.conf. See the CONFIGURATION FILES section below.
The following notation is used throughout this page:
M Meta
S Shift
C Control
M1 Mouse button 1
xxxterm is very simple in its use. Most of the actions are initiated via
key or mouse bindings. See the BINDINGS section below for defaults and
customizations.
The options are as follows:
-f file
Use alternate config file.
-S Disable the toolbar.
-T Disable visualization of tabs.
-t Disable tabs.
-V Display version and exit.
CONFIGURATION FILES
xxxterm tries to open the user specific file, ~/.xxxterm.conf. If that
file is unavailable, it then uses built-in defaults.
The format of the file is <keyword> = <setting>. For example:
http_proxy = http://127.0.0.1:8080
Enabling or disabling an option is done by using 1 or 0 respectively.
The file supports the following keywords:
ctrl_click_focus Give focus in newly created tab instead of
opening it in the background.
read_only_cookies Mark cookies file read-only and discard all
cookies once the sessions is terminated.
cookies_enabled Enable cookies.
enable_scripts Enable scripts.
enable_plugins Enable plugins.
default_font_size Set the default browsing font size.
http_proxy Proxy server in URI format.
download_dir Locations where files are downloaded to.
This directory must exist and xxxterm
validates that during startup.
fancy_bar Enables a backward, forward and stop button
to the toolbar. Additionally if
search_string is set it'll enable an entry
box for searches.
search_string Default search engine string. See
xxxterm.conf file for details.
mime_type Sets an action for a specific or default
MIME type. For example, to download and
view a pdf using kpdf set mime_type =
application/pdf,kpdf. To set a default
value use *, for example mime_type =
video/*,mplayer. Note that the action is
only passed the URI and not all
applications are capable of downloading
content and therefore one might have to
create a wrapper script to download the
content first.
alias Defines an alias for a given URL, so that
the URL is loaded when the alias is entered
in the address bar. If the aliased URL
includes a %s format specifier, then any
argument given after the alias on the
address bar is substituted. For example,
if g,http://www.google.com/search?q=%s is
defined as an alias, then the URL
http://www.google.com/search?q=foo is
loaded when navigating to "g foo".
xxxterm overrides http_proxy if it is specified as an environment
variable.
BINDINGS
xxxterm provides many functions (or actions) accessed via key or mouse
bindings.
The current mouse bindings are described below:
C-M1 Open new tab with the clicked link.
The default key bindings are described below.
Search:
/ Start a search
? Start a backwards search
n Next item matching search
N Previous item matching search
Focus:
F6 Focus on URI entry
F7 Focus on search entry
Navigation:
F5, C-r, C-l Refresh page
Backspace Previous page
M-Left Previous page
S-BackSpace, M-Right Forward page
j, Down Next line on page
k, Up Previous line on page
G, End Bottom of page
gg, Home Top of page
Space, C-f, PageDown Page down
C-b, PageUp Page up
l, Right Page right
h, Left Page left
$ Page far right
0 Page far left
Tab Manipulation:
C-T Create new tab with focus in URI entry
C-W Destroy current tab
C-[1..0] Jump to page N
C-minus Shrink font size by one point.
C-plus, C-equal Grow font size by one point.
Mouse-less browsing:
f Highlight all links and prefix them
with a number. Press number to follow
link. Alternatively one can type the
name of the link and when there are no
more possibilities xxxterm will follow
the link.
Exiting:
C-Q Quit
Note: WebKit & GTK+ have many default key bindings that are not overruled
and therefore are available as-is.
Command mode is entered by typing a colon and exited by typing Esc. The
commands and descriptions are listed below:
qa, qa!, q! Quit xxxterm
fav Show favorites
favadd Add current page to favorites
help Show help file.
open, op, o <URI> Open URI.
tabnew, tabedit, tabe [URI] Create new tab and optionally open
provided URI
tabclose, tabc Close current tab.
quit, q Close current tab and quit xxxterm if
it is the last tab.
tabprevious, tabp Go to the previous tab.
tabnext, tabn Go to the next tab.
FILES
~/.xxxterm.conf xxxterm user specific settings.
~/.xxxterm xxxterm scratch directory.
HISTORY
xxxterm was inspired by vimprobable2 and the bloat in other UNIX web
browsers.
AUTHORS
xxxterm was written by Marco Peereboom <marco@peereboom.us>
OpenBSD 4.8 August 12, 2010 OpenBSD 4.8