surf(1) - f39

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

NAME

6       surf - simple webkit-based browser
7

SYNOPSIS

9       surf  [-bBdDfFgGiIkKmMnNpPsStTvwxX] [-a cookiepolicies] [-c cookiefile]
10       [-C stylefile] [-e xid] [-r scriptfile]  [-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       -C stylefile
34              Specify the user stylefile.  This does disable the site-specific
35              styles.
36
37       -d     Disable the disk cache.
38
39       -D     Enable the disk cache.
40
41       -e xid Reparents to window specified by xid.
42
43       -f     Start surf in windowed mode (not fullscreen).
44
45       -F     Start surf in fullscreen mode.
46
47       -g     Disable giving the geolocation to websites.
48
49       -G     Enable giving the geolocation to websites.
50
51       -i     Disable Images.
52
53       -I     Enable Images.
54
55       -k     Disable kiosk mode (disable key strokes and right click).
56
57       -K     Enable kiosk mode (disable key strokes and right click).
58
59       -m     Disable application of user style sheets.
60
61       -M     Enable application of user style sheets.
62
63       -n     Disable the Web Inspector (Developer Tools).
64
65       -N     Enable the Web Inspector (Developer Tools).
66
67       -r scriptfile
68              Specify the user scriptfile.
69
70       -s     Disable Javascript.
71
72       -S     Enable Javascript.
73
74       -t     Disable strict TLS check.
75
76       -T     Enable strict TLS check.
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       -w     Prints xid to standard output. This can be used  to  script  the
84              browser in for example xdotool(1).
85
86       -x     Disable custom certificates.
87
88       -X     Enable custom certificates.
89
90       -z zoomlevel
91              Specify the zoomlevel which surf should use.
92

USAGE

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

INDICATORS OF OPERATION

176       Surf is showing indicators of operation in front  of  the  site  title.
177       For  all  indicators,  unless  otherwise specified, a lower case letter
178       means disabled and an upper case letter means enabled.
179
180       A      all cookies accepted
181
182       a      no cookies accepted
183
184       @      all except third-party cookies accepted
185
186       c C    caret browsing
187
188       g G    geolocation
189
190       d D    disk cache
191
192       i I    images
193
194       s S    scripts
195
196       m M    styles
197
198       f F    frame flattening
199
200       x X    custom certificates
201
202       t T    strict TLS
203

INDICATORS OF WEB PAGE

205       The second part of the indicators specifies modes of the web  page  it‐
206       self.
207
208   First character: encryption
209       -      unencrypted
210
211       T      encrypted (TLS)
212
213       U      attempted encryption but failed
214
215   Second character: proxying
216       -      no proxy
217
218       P      using proxy
219

ENVIRONMENT

221       SURF_USERAGENT  If  this variable is set upon startup, surf will use it
222       as the useragent string.
223
224       http_proxy
225              If this variable is set and not empty upon  startup,  surf  will
226              use it as the http proxy.
227

SIGNALS

229       Surf will reload the current page on SIGHUP.
230

BUGS

235       Please report them!
236
237
238
239                                   surf-2.1                            SURF(1)