_ _
___ | |__ __ _ _______ | |_
/ _ \| '_ \ / _` |_ / _ \| __|
| (_) | | | | (_| |/ / (_) | |_
\___/|_| |_|\__,_/___\___/ \__|
surf —
suckless web browser - usage
Surf uses webkit2gtk-4.1. The file config.mk can be changed to use
webkit2gtk-4.0 if 4.1 is not available.
I have not found the need to use any patches yet. This section
will be updated if any patches are tested.
(back to top)
| Stylesheets can be added in ~/.surf/styles/. |
| add the entry for a website to use any specific stylesheet.
{ .*suckless.org.*, custom.css
},
|
| The first matching style will be applied. |
(back to top)
| -a <policy> |
: cookie policy. |
| -c <file> |
: specify cookie file. |
| -C <file> |
: specify style file. |
| -e <xid> |
: reparent to window id. |
| -r <file> |
: specify user script. |
| -u <agent> |
: specify useragent. |
| -v |
: print version. |
| -w |
: print window id. |
| -z <zoom> |
: specify zoom level. |
| option |
disable/enable |
| -[b|B] |
: scrollbars. |
| -[d|D] |
: disable/enable disk cache. Default: enabled. |
| -[g|G] |
: disable/enable geolocation. Default: disabled. |
| -[i|I] |
: disable/enable images. Default: enabled. |
| -[k|K] |
: disable/enable kiosk mode (key strokes and right click). |
| -[m|M] |
: stylesheets. Default: enabled. |
| -[n|N] |
: web inspector (developer tools). Default: disabled. |
| -[s|S] |
: javascript. Default: disabled. |
| -[t|T] |
: strict TLS checkl. Default: enabled. |
| -[x|X] |
: custom certificates. |
(back to top)
| Escape |
: stop loading page. |
| Ctrl-[h|l] |
: go back/forth in history. |
| Ctrl-[j|k] |
: scroll page up/down. |
| Ctrl-b |
: scroll one page up. |
| Ctrl-space |
: scroll one page down. |
| Ctrl-[i|u] |
: scroll horizontally right/left. |
| Ctrl-[Shift-k|+] |
: zoom in. |
| Ctrl-[Shift-j|-] |
: zoom out. |
| Ctrl-Shift-q |
: reset zoom. |
| Ctrl-[f|/] |
: open search bar. |
| Ctrl-[n|N] |
: go to next/previous search result. |
| Ctrl-g |
: open url bar (requires dmenu). |
| Ctrl-p |
: loads url from primary selection. |
| Ctrl-r |
: reload page. |
| Ctrl-R |
: reload page without cache. |
| Ctrl-y |
: copy current url to primary selection. |
| Ctrl-t |
: display current TLS certificate in a popup window. |
| Ctrl-Shift-a |
: toggle cookie policy. |
| Ctrl-Shift-b |
: toggle scrollbars. Reloads. |
| Ctrl-Shift-d |
: toggle darkmode |
|
Only available from source. Not available on the latest
version 2.1. |
| Ctrl-Shift-i |
: toggle auto-loading images. Reloads. |
| Ctrl-Shift-m |
: toggle stylesheet. Reloads. |
| Ctrl-Shift-o |
: open webinspector. |
| Ctrl-Shift-s |
: toggle scripts. Reloads. |
| Ctrl-Shift-t |
: toggle strict TLS check. Reloads. |
| F11 |
: toggle fullscreen. |
(back to top)
| - Using surf with tabbed and hidetabs tabs can conflict with some
keybindings. |
| Eg.: Ctrl-m to toggle stylesheet. |
| - Some keybindings may conflict with tabbed. |
| Eg.: Ctrl-Shift-[j|k] to zoom in conflicts with moving
tabs in tabbed. |
| I have changed the keybinding to zZ for zoomin/out. |
(back to top)
| - Translate to Spanish. |
| - Check how to copy the url under cursor without using the menu. |
| - Check if there is a way to redirect to http when there is no
https. |