.\" $xxxterm$ .\" .\" Copyright (c) 2010 Marco Peereboom .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .Dd $Mdocdate$ .Dt XXXTERM 1 .Os .Sh NAME .Nm xxxterm .Nd lightweight web browser with vi key bindings .Sh SYNOPSIS .Nm xxxterm .Bk -words .Op Fl STtV .Op Fl f Ar file .Op Ar uri ... .Ek .Sh DESCRIPTION .Nm 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. .Pp When .Nm starts up, it reads settings from its configuration file, .Pa xxxterm.conf . See the .Sx CONFIGURATION FILES section below. .Pp The following notation is used throughout this page: .Pp .Bl -tag -width Ds -offset indent -compact .It Cm M Meta .It Cm S Shift .It Cm C Control .It Cm M1 Mouse button 1 .El .Pp .Nm is very simple in its use. Most of the actions are initiated via key or mouse bindings. See the .Sx BINDINGS section below for defaults and customizations. .Pp The options are as follows: .Bl -tag -width Ds .It Fl f Ar file Use alternate config file. .It Fl S Disable the toolbar. .It Fl T Disable visualization of tabs. .It Fl t Disable tabs. .It Fl V Display version and exit. .El .Sh CONFIGURATION FILES .Nm tries to open the user specific file, .Pa ~/.xxxterm.conf . If that file is unavailable, it then uses built-in defaults. .Pp The format of the file is \*(Ltkeyword\*(Gt = \*(Ltsetting\*(Gt. For example: .Pp .Dl http_proxy = http://127.0.0.1:8080 .Pp Enabling or disabling an option is done by using 1 or 0 respectively. .Pp The file supports the following keywords: .Pp .Bl -tag -width "title_class_enabledXXX" -offset indent -compact .It Cm ctrl_click_focus Give focus in newly created tab instead of opening it in the background. .It Cm read_only_cookies Mark cookies file read-only and discard all cookies once the sessions is terminated. .It Cm cookies_enabled Enable cookies. .It Cm enable_scripts Enable scripts. .It Cm enable_plugins Enable plugins. .It Cm default_font_size Set the default browsing font size. .It Cm http_proxy Proxy server in URI format. .It Cm download_dir Locations where files are downloaded to. This directory must exist and .Nm validates that during startup. .It Cm 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. .It Cm refresh_interval Refresh interval while in the download manager. Default is 10. .It Cm session_timeout If this value is greater than 3600 then it is the time added in seconds to a session cookie. If the value is smaller than 3600 then there is no change to the expiration of a session cookie. .It Cm enable_cookie_white list When enabled all cookies must be in the white list or they are rejected. .It Cm cookie_wl This is a cookie white list item. Use multiple times to add multiple entries. Valid entries are for example *.moo.com and the equivalent .moo.com. A fully qualified host is also valid and is for example www.moo.com. .It Cm cookie_policy This field delineates the cookie policy. Possible values are: no3rdparty, reject 3rd party cookies. accept, accept all cookies. reject, reject all cookies. .It Cm enable_js_whitelist When enabled all domains must be in the js white list in order to run javascript. NOTE: Make sure enable_scripts is set to 0. .It Cm js_wl This is a javascript white list item. See cookie_wl for semantics and more details. .It Cm search_string Default search engine string. See xxxterm.conf file for details. .It Cm 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. .It Cm 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". .El .Pp .Nm overrides http_proxy if it is specified as an environment variable. .Sh BINDINGS .Nm provides many functions (or actions) accessed via key or mouse bindings. .Pp The current mouse bindings are described below: .Pp .Bl -tag -width "tabnew, tabedit, tabe [URI]" -offset indent -compact .It Cm C-M1 Open new tab with the clicked link. .El .Pp The default key bindings are described below. .Pp Search: .Pp .Bl -tag -width "tabnew, tabedit, tabe [URI]" -offset indent -compact .It Cm / Start a search .It Cm ? Start a backwards search .It Cm n Next item matching search .It Cm N Previous item matching search .El .Pp Focus: .Pp .Bl -tag -width "tabnew, tabedit, tabe [URI]" -offset indent -compact .It Cm F6 Focus on URI entry .It Cm F7 Focus on search entry .El .Pp Navigation: .Pp .Bl -tag -width "tabnew, tabedit, tabe [URI]" -offset indent -compact .It Cm F5, C-r, C-l Refresh page .It Cm Backspace Previous page .It Cm M-Left Previous page .It Cm S-BackSpace, M-Right Forward page .It Cm j, Down Next line on page .It Cm k, Up Previous line on page .It Cm G, End Bottom of page .It Cm gg, Home Top of page .It Cm Space, C-f, PageDown Page down .It Cm C-b, PageUp Page up .It Cm l, Right Page right .It Cm h, Left Page left .It Cm $ Page far right .It Cm 0 Page far left .It Cm C-f Favorites .It Cm M-d Download manager .It Cm C-p Print page .It Cm C-h Global history .El .Pp Tab Manipulation: .Pp .Bl -tag -width "tabnew, tabedit, tabe [URI]" -offset indent -compact .It Cm C-T Create new tab with focus in URI entry .It Cm C-W Destroy current tab .It Cm C-[1..0] Jump to page N .It Cm C-minus Shrink font size by one point. .It Cm C-plus, C-equal Grow font size by one point. .El .Pp Mouse-less browsing (a.k.a. link following): .Pp .Bl -tag -width "tabnew, tabedit, tabe [URI]" -offset indent -compact .It Cm 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 .Nm will follow the link. .El .Pp Exiting: .Pp .Bl -tag -width "tabnew, tabedit, tabe [URI]" -offset indent -compact .It Cm C-Q Quit .El .Pp Note: WebKit & GTK+ have many default key bindings that are not overruled and therefore are available as-is. .Pp Command mode is entered by typing a colon and exited by typing Esc. The commands and descriptions are listed below: .Pp .Bl -tag -width "tabnew, tabedit, tabe [URI]" -offset indent -compact .It Cm qa, qa!, q! Quit .Nm .It Cm fav Show favorites .It Cm favadd Add current page to favorites .It Cm dl Show download manager .It Cm print Print page .It Cm h, hist, history Global history .It Cm help Show help file. .It Cm open, op, o Open URI. .It Cm tabnew, tabedit, tabe [URI] Create new tab and optionally open provided URI .It Cm tabclose, tabc Close current tab. .It Cm quit, q Close current tab and quit .Nm if it is the last tab. .It Cm tabprevious, tabp Go to the previous tab. .It Cm tabnext, tabn Go to the next tab. .El .Sh FILES .Bl -tag -width "/etc/xxxterm.confXXX" -compact .It Pa ~/.xxxterm.conf .Nm user specific settings. .It Pa ~/.xxxterm .Nm scratch directory. .El .Sh HISTORY .Nm was inspired by vimprobable2 and the bloat in other UNIX web browsers. .Sh AUTHORS .An -nosplit .Pp .Nm was written by .An Marco Peereboom Aq marco@peereboom.us , and .An Edd Barrett Aq vext01@gmail.com