Add documentation of referer-setting

[xombrero.git] / xxxterm.conf

##
## GENERAL SETTINGS
##

# NOTE: browser_mode and gui_mode MUST be the first entries in this
# file!

# Normal browser operation (default).
# browser_mode          = normal

# Prevent tracking operation.
# browser_mode          = whitelist

# Classic GUI (default).
# gui_mode              = classic

# Minimalistic GUI.
# gui_mode              = minimal

# home                  = https://www.cyphertite.com
# download_dir          = ~/downloads
# download_mode         = start
# window_maximize       = 1
# window_width          = 1024
# window_height         = 768
# enable_spell_checking = 1
# spell_check_languages = en_US
# default_zoom_level    = 1.0
# encoding              = UTF-8
# ssl_ca_file           = /etc/ssl/cert.pem
# ssl_strict_certs      = 1
# ctrl_click_focus      = 1
# append_next           = 0
# save_global_history   = 1
# color_visited_uris    = 0
# guess_search          = 1
# enable_autoscroll     = 1
# session_autosave      = 1
# history_autosave      = 1
# autofocus_onload      = 1
# xterm_workaround      = 1
# single_instance       = 1
# enable_socket         = 1
# js_autorun_enabled    = 0
# auto_load_images      = 0
# enable_localstorage   = 0
# userstyle_global      = 1
# enable_favicon_entry  = 0
# enable_favicon_tabs   = 1
# referer               = always

# See http://www.xroxy.com/proxylist.php for a good list of open
# proxies.
#
# http_proxy = http://127.0.0.1:80

# Search engines; uncomment one of these lines for you favorite search
# engine.
#
# Scroogle (default)
# search_string         = https://ssl.scroogle.org/cgi-bin/nbbwssl.cgi?Gw=%s
# search_string         = http://www.scroogle.org/cgi-bin/nbbw.cgi?Gw=%s
#
# Google
# search_string         = http://www.google.com/search?q=%s&&client=xxxterm
#
# Yahoo
# search_string         = http://search.yahoo.com/search?p=%s

# External editor.
# NOTE: The editor specified here must not fork into the background.
#
# Examples of editors:
# external_editor       = gvim -f <file>
# external_editor       = xterm -geometry 177x58+0+0 -font -*-fixed-medium-r-*-*-15-*-*-*-*-*-iso8859-* -e vim -f <file>
# external_editor       = emacsclient -c <file>

# "default_script" points to a script executed by the run_script
# command. The only argument passed to this script is the current URI.
#
# default_script        = ~/.xxxterm/playflash.sh

# "user_agent" can be set to just about anything, for a comprehensive
# list see: http://www.useragentstring.com/pages/All/ . If more than one
# "user_agent" is given, then xxxterm will use them in a round-robin
# fashion for each request.
#
user_agent              = Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.1.3) Gecko/20090824 Firefox/3.5.3 (.NET CLR 3.5.30729)
user_agent              = Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)
user_agent              = Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US) AppleWebKit/532.0 (KHTML, like Gecko) Chrome/3.0.195.27 Safari/532.0
user_agent              = Mozilla/5.0 (iPhone; U; CPU iPhone OS 3_1 like Mac OS X; en-us) AppleWebKit/528.18 (KHTML, like Gecko) Version/4.0 Mobile/7C144 Safari/528.16


##
## ALIASES
##

# Aliases are given in the following format:
#
#   alias = <alias>, <link>
#
# Where the link part might contain "%s", the "%s" will be substituted
# with the user's input when the alias is expanded.

# alias = s,      https://ssl.scroogle.org/cgi-bin/nbbwssl.cgi?Gw=%s
# alias = w,      https://secure.wikimedia.org/wikipedia/en/w/index.php?title=Special%3ASearch&search=%s
# alias = ports,  http://openports.se/search.php?so=%s


##
## COOKIE, JAVASCRIPT AND PLUGIN WHITE LISTS
##

# Add the domains you trust.

# cookie_wl             = .conformal.com
# cookie_wl             = .peereboom.us

# js_wl                 = .conformal.com
# js_wl                 = .peereboom.us

# pl_wl                 = .conformal.com
# pl_wl                 = .peereboom.us


##
## MIME TYPES
##

# PDF, note that xpdf can't load a URI directly; use "@" in front of
# mime_type to indicate to download the file first.

# mime_type             = application/pdf,kpdf
# mime_type             = @application/pdf,xpdf

# Specific MIME type for video.
# mime_type             = video/x-ms-wmv,mplayer
# mime_type             = video/quicktime,mplayer

# Default MIME type for video.
# mime_type             = video/*,mplayer

# Default MIME type for audio.
# mime_type             = audio/*,vlc

# Word documents.
# mime_type             = application/msword,soffice

# Ignoring flash can be done by using a non-existent binary name.
# mime_type             = application/x-shockwave-flash,donothing


##
## ADVANCED SETTINGS
##

# resource_dir          = /usr/local/share/xxxterm/
# refresh_interval      = 10
# url_regex             = ^[[:blank:]]*[^[:blank:]]*([[:alnum:]-]+\.)+[[:alnum:]-][^[:blank:]]*[[:blank:]]*$

# NOTE: webkit 1.4.x overwrites these values!
# max_host_connections  = 5
# max_connections       = 25


##
## ADVANCED GUI SETTINGS
##

# The following low-level GUI settings are set by the high-level setting
# "gui_mode".

# The settings for "gui_mode = classic" are as follows:

# fancy_bar             = 1
# show_tabs             = 1
# tab_style             = normal
# show_url              = 1
# show_statusbar        = 0

# The settings for "gui_mode = minimal" are as follows:

# fancy_bar             = 0
# show_tabs             = 1
# tab_style             = compact
# show_url              = 0
# show_statusbar        = 1

# The following are settings shared between "classic" and "minimal"
# "gui_mode":

# statusbar_elems       = BP
# icon_size             = 2
# cmd_font              = monospace normal 9
# oops_font             = monospace normal 9
# statusbar_font        = monospace normal 9
# tabbar_font           = monospace normal 9


##
## ADVANCED COOKIE AND JAVASCRIPT SETTINGS
##

# The following low-level settings are set by the high-level setting
# "browser_mode", and shouldn't be tweaked manually unless you know what
# you are doing.

# The settings for "browser_mode = normal" are as follows:

# allow_volatile_cookies        = 0
# cookie_policy                 = allow
# cookies_enabled               = 1
# enable_cookie_whitelist       = 0
# read_only_cookies             = 0
# save_rejected_cookies         = 0
# session_timeout               = 3600
# enable_scripts                = 1
# enable_js_whitelist           = 0
# enable_localstorage           = 1
# enable_plugins                = 1
# enable_plugin_whitelist       = 0

# The settings for "browser_mode = whitelist" are as follows:

# allow_volatile_cookies        = 0
# cookie_policy                 = no3rdparty
# cookies_enabled               = 1
# enable_cookie_whitelist       = 1
# read_only_cookies             = 0
# save_rejected_cookies         = 0
# session_timeout               = 3600
# enable_scripts                = 0
# enable_js_whitelist           = 1
# enable_localstorage           = 0
# enable_plugins                = 0
# enable_plugin_whitelist       = 1


##
## KEY BINDINGS
##

# To delete all default keybindings use "keybinding = clearall".
#
# keybinding    = clearall
#
# Key names can be found at:
#
#   http://git.gnome.org/browse/gtk+/tree/gdk/gdkkeysyms-compat.h
#
# Just chop off the "GDK_" part and you have the keyname. Or look at:
#
#   http://git.gnome.org/browse/gtk+/tree/gdk/gdkkeysyms.h
#
# and chop off "GDK_KEY_".
#
# Be aware that the names are case sensitive!
#
# The default keybindings are the following:
#
# keybinding    = command,colon
# keybinding    = search,slash
# keybinding    = searchb,question
# keybinding    = command_mode,Escape
# keybinding    = insert_mode,i
# keybinding    = cookiejar,M1-j
# keybinding    = downloadmgr,M1-d
# keybinding    = history,M1-h
# keybinding    = print,C-p
# keybinding    = quitall,C-q
# keybinding    = restart,M1-q
# keybinding    = run_script,M1-r
# keybinding    = js toggle,C-j
# keybinding    = cookie toggle,M1-c
# keybinding    = togglesrc,C-s
# keybinding    = yankuri,y
# keybinding    = pasteuricur,p
# keybinding    = pasteurinew,P
# keybinding    = toplevel toggle,F4
# keybinding    = help,F1
# keybinding    = proxy toggle,F2
# keybinding    = searchnext,n
# keybinding    = searchprevious,N
# keybinding    = focusaddress,F6
# keybinding    = focussearch,F7
# keybinding    = promptopen,F9
# keybinding    = promptopencurrent,F10
# keybinding    = prompttabnew,F11
# keybinding    = prompttabnewcurrent,F12
# keybinding    = hinting,f
# keybinding    = hinting,period
# keybinding    = hinting_newtab,S-F
# keybinding    = hinting_newtab,comma
# keybinding    = userstyle,s
# keybinding    = userstyle_global,S
# keybinding    = goback,BackSpace
# keybinding    = goback,M1-Left
# keybinding    = goforward,S-BackSpace
# keybinding    = goforward,M1-Right
# keybinding    = reload,F5
# keybinding    = reload,C-r
# keybinding    = reload,C-l
# keybinding    = favorites,!M1-f
# keybinding    = scrolldown,j
# keybinding    = scrolldown,Down
# keybinding    = scrollup,k
# keybinding    = scrollup,Up
# keybinding    = scrollbottom,G
# keybinding    = scrollbottom,End
# keybinding    = scrolltop,Home
# keybinding    = scrollpagedown,space
# keybinding    = scrollpagedown,C-f
# keybinding    = scrollpagedown,Page_Down
# keybinding    = scrollhalfdown,C-d
# keybinding    = scrollpageup,Page_Up
# keybinding    = scrollpageup,C-b
# keybinding    = scrollhalfup,C-u
# keybinding    = scrollright,l
# keybinding    = scrollright,Right
# keybinding    = scrollfarright,dollar
# keybinding    = scrollleft,h
# keybinding    = scrollleft,Left
# keybinding    = scrollfarleft,0
# keybinding    = statustoggle,C-n
# keybinding    = tabnew,C-t
# keybinding    = tabclose,!C-w
# keybinding    = tabundoclose,U
# keybinding    = tabnext 1,C-1
# keybinding    = tabnext 2,C-2
# keybinding    = tabnext 3,C-3
# keybinding    = tabnext 4,C-4
# keybinding    = tabnext 5,C-5
# keybinding    = tabnext 6,C-6
# keybinding    = tabnext 7,C-7
# keybinding    = tabnext 8,C-8
# keybinding    = tabnext 9,C-9
# keybinding    = tabfirst,C-less
# keybinding    = tablast,C-greater
# keybinding    = tabprevious,C-Left
# keybinding    = tabnext,C-Right
# keybinding    = focusout,C-minus
# keybinding    = focusin,C-equal
# keybinding    = focusin,C-plus
# keybinding    = focusreset,C-0
# keybinding    = editelement,!C-i
# keybinding    = passthrough,C-z