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 vali-
                                   dates 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.

     xxxterm overrides http_proxy if it is specified as an environment vari-
     able.

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
           n                            Next item matching search
           N                            Previous item matching search
           ?                            Previous item matching search

     Focus:

           F6                           Focus on URI entry

     Navigation:

           F5                           Refresh page
           C-r                          Refresh page
           C-l                          Refresh page
           Backspace                    Previous page
           M-Left                       Previous page
           S-BackSpace                  Forward page
           M-Right                      Forward page
           j                            Next line on page
           Down                         Next line on page
           k                            Previous line on page
           Up                           Previous line on page
           G                            Bottom of page
           End                          Bottom of page
           gg                           Top of page
           Home                         Top of page
           Space                        Page down
           PageDown                     Page down
           C-f                          Page down
           C-b                          Page up
           PageUp                       Page up
           l                            Page right
           Right                        Page right
           h                            Page left
           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                       Grow font size by one point.

     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
           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.7                    February 25, 2010                             3