1SURF(1)                     General Commands Manual                    SURF(1)
2
3
4

NAME

6       surf - simple webkit-based browser
7

SYNOPSIS

9       surf   [-bBdDfFgGiIkKmMnNpPsSvx]   [-a cookiepolicies]  [-c cookiefile]
10       [-e xid] [-r scriptfile] [-t stylefile]  [-u useragent]  [-z zoomlevel]
11       URI
12

DESCRIPTION

14       surf  is  a simple Web browser based on WebKit/GTK+. It is able to dis‐
15       play websites and follow links. It supports the XEmbed  protocol  which
16       makes  it possible to embed it in another application. Furthermore, one
17       can point surf to another URI by setting its XProperties.
18

OPTIONS

20       -a cookiepolicies
21              Define the order of cookie policies.  The default is  "Aa@"  but
22              could  be  redefined in the config.h, with "A" meaning to accept
23              all cookies, "a" to deny all cookies and "@", which  tells  surf
24              to accept no third party cookies.
25
26       -b     Disable Scrollbars
27
28       -B     Enable Scrollbars
29
30       -c cookiefile
31              Specify the cookiefile to use.
32
33       -d     Disable the disk cache.
34
35       -D     Enable the disk cache.
36
37       -e xid Reparents to window specified by xid.
38
39       -f     Start surf in windowed mode (not fullscreen).
40
41       -F     Start surf in fullscreen mode.
42
43       -g     Disable giving the geolocation to websites.
44
45       -G     Enable giving the geolocation to websites.
46
47       -i     Disable Images
48
49       -I     Enable Images
50
51       -k     Disable kiosk mode (disable key strokes and right click)
52
53       -K     Enable kiosk mode (disable key strokes and right click)
54
55       -m     Disable application of user style sheets.
56
57       -M     Enable application of user style sheets.
58
59       -n     Disable the Web Inspector (Developer Tools).
60
61       -N     Enable the Web Inspector (Developer Tools).
62
63       -p     Disable Plugins
64
65       -P     Enable Plugins
66
67       -r scriptfile
68              Specify the user scriptfile.
69
70       -s     Disable Javascript
71
72       -S     Enable Javascript
73
74       -t stylefile
75              Specify the user stylefile.  This does disable the site-specific
76              styles.
77
78       -u useragent
79              Specify the useragent which surf should use.
80
81       -v     Prints version information to standard output, then exits.
82
83       -x     Prints xid to standard output. This can be used  to  script  the
84              browser in for example xdotool(1).
85
86       -z zoomlevel
87              Specify the zoomlevel which surf should use.  xprop(1).
88

USAGE

90       Escape Stops loading current page or stops download.
91
92       Ctrl-h Walks back the history.
93
94       Ctrl-l Walks forward the history.
95
96       Ctrl-k Scrolls page upwards.
97
98       Ctrl-j Scrolls page downwards.
99
100       Ctrl-b Scroll up one whole page view.
101
102       Ctrl-Space
103              Scroll down one whole page view.
104
105       Ctrl-i Scroll horizontally to the right.
106
107       Ctrl-u Scroll horizontally to the left.
108
109       Ctrl-Shift-k or Ctrl-+
110              Zooms page in.
111
112       Ctrl-Shift-j or Ctrl--
113              Zooms page out
114
115       Ctrl-Shift-q
116              Resets Zoom
117
118       Ctrl-f and Ctrl-/
119              Opens the search-bar.
120
121       Ctrl-n Go to next search result.
122
123       Ctrl-Shift-n
124              Go to previous search result.
125
126       Ctrl-g Opens the URL-bar (requires dmenu installed).
127
128       Ctrl-p Loads URI from primary selection.
129
130       Ctrl-Shift-p
131              Calls Printpage Dialog.
132
133       Ctrl-r Reloads the website.
134
135       Ctrl-Shift-r
136              Reloads the website without using the cache.
137
138       Ctrl-y Copies current URI to primary selection.
139
140       Ctrl-o Show the sourcecode of the current page.
141
142       Ctrl-Shift-a
143              Toggle  through  the  the cookie policies.  This will not reload
144              the page.
145
146       Ctrl-Shift-b
147              Toggle scrollbars. This will reload the page.
148
149       Ctrl-Shift-c
150              Toggle caret browsing. This will reload the page.
151
152       Ctrl-Shift-i
153              Toggle auto-loading of images. This will reload the page.
154
155       Ctrl-Shift-m
156              Toggle if the stylefile file should be loaded. This will  reload
157              the page.
158
159       Ctrl-Shift-o
160              Open  the Web Inspector (Developer Tools) window for the current
161              page.
162
163       Ctrl-Shift-s
164              Toggle script execution. This will reload the page.
165
166       Ctrl-Shift-v
167              Toggle the enabling of plugins on that surf instance. This  will
168              reload the page.
169
170       F11    Toggle fullscreen mode.
171

INDICATORS OF OPERATION

173       Surf  is  showing  indicators  of operation in front of the site title.
174       For all indicators, unless otherwise specified,  a  lower  case  letter
175       means disabled and an upper case letter means enabled.
176
177       A      all cookies accepted
178
179       a      no cookies accepted
180
181       @      all except third-party cookies accepted
182
183       c C    caret browsing
184
185       g G    geolocation
186
187       d D    disk cache
188
189       i I    images
190
191       s S    scripts
192
193       v V    plugins
194
195       m M    styles
196

INDICATORS OF WEB PAGE

198       The  second  part  of  the  indicators  specifies modes of the web page
199       itself.
200
201   First character: encryption
202       -      unencrypted
203
204       T      encrypted (SSL)
205
206       U      attempted encryption but failed
207
208   Second character: proxying
209       -      no proxy
210
211       P      using proxy
212

ENVIRONMENT

214       SURF_USERAGENT If this variable is set upon startup, surf will  use  it
215       as the useragent string
216
217       http_proxy
218              If  this  variable  is set and not empty upon startup, surf will
219              use it as the http proxy
220

PLUGINS

222       For using plugins in surf, first determine your  running  architecture.
223       Then  get  the  appropriate plugin for that architecture and copy it to
224       /usr/lib/browser-plugins or  /usr/lib64/browser-plugins.   Surf  should
225       load them automatically.   If you want to use a 32bit plugin on a 64bit
226       system, nspluginwrapper(1) will help you.
227

SEE ALSO

229       dmenu(1), xprop(1), tabbed(1), nspluginwrapper(1), xdotool(1)
230

BUGS

232       Please report them!
233
234
235
236                                   surf-2.0                            SURF(1)
Impressum