.Dd 2026-07-11 .de oit .It \\$* .. .de obi .Bl -\\$1 -compact .shift .oit \\$* .. .de obe .obi \\$* .El .. .de obd .Bd -literal -compact \\$* .. .de obc .Bl -column \\$* .. .Dt SURF oh .Os Linux OpenBSD | .Nm surf .Nd suckless web browser - usage .Sh COMPILE Surf uses webkit2gtk-4.1. The file config.mk can be changed to use webkit2gtk-4.0 if 4.1 is not available. .Sh PATCHES I have not found the need to use any patches yet. This section will be updated if any patches are tested. .Sh STYLES .obc .It Stylesheets can be added in ~/.surf/styles/. .It add the entry for a website to use any specific stylesheet. .Dl { ".*suckless.org.*", "custom.css" }, .It The first matching style will be applied. .El .Sh OPTIONS .obc _policy_ .It -a Ta : cookie policy. .It -c Ta : specify cookie file. .It -C Ta : specify style file. .It -e Ta : reparent to window id. .It -r Ta : specify user script. .It -u Ta : specify useragent. .It -v Ta : print version. .It -w Ta : print window id. .It -z Ta : specify zoom level. .El .Ss Toggles .obc g_g disable_ena .It option Ta disable/enable .It -[b|B] Ta : scrollbars. .It -[d|D] Ta : disable/enable disk cache. Default: enabled. .It -[g|G] Ta : disable/enable geolocation. Default: disabled. .It -[i|I] Ta : disable/enable images. Default: enabled. .It -[k|K] Ta : disable/enable kiosk mode (key strokes and right click). .It -[m|M] Ta : stylesheets. Default: enabled. .It -[n|N] Ta : web inspector (developer tools). Default: disabled. .It -[s|S] Ta : javascript. Default: disabled. .It -[t|T] Ta : strict TLS checkl. Default: enabled. .It -[x|X] Ta : custom certificates. .El .El .Sh KEYBINDINGS .obc ctrelshifta__ .It Escape Ta : stop loading page. .It Ctrl-[h|l] Ta : go back/forth in history. .It Ctrl-[j|k] Ta : scroll page up/down. .It Ctrl-b Ta : scroll one page up. .It Ctrl-space Ta : scroll one page down. .It Ctrl-[i|u] Ta : scroll horizontally right/left. .It Ctrl-[Shift-k|+] Ta : zoom in. .It Ctrl-[Shift-j|-] Ta : zoom out. .It Ctrl-Shift-q Ta : reset zoom. .It Ctrl-[f|/] Ta : open search bar. .It Ctrl-[n|N] Ta : go to next/previous search result. .It Ctrl-g Ta : open url bar (requires dmenu). .It Ctrl-p Ta : loads url from primary selection. .It Ctrl-r Ta : reload page. .It Ctrl-R Ta : reload page without cache. .It Ctrl-y Ta : copy current url to primary selection. .It Ctrl-t Ta : display current TLS certificate in a popup window. .It Ctrl-Shift-a Ta : toggle cookie policy. .It Ctrl-Shift-b Ta : toggle scrollbars. Reloads. .It Ctrl-Shift-d Ta : toggle darkmode .It Ta \ \ Only available from source. Not available on the latest version 2.1. .It Ctrl-Shift-i Ta : toggle auto-loading images. Reloads. .It Ctrl-Shift-m Ta : toggle stylesheet. Reloads. .It Ctrl-Shift-o Ta : open webinspector. .It Ctrl-Shift-s Ta : toggle scripts. Reloads. .It Ctrl-Shift-t Ta : toggle strict TLS check. Reloads. .It F11 Ta : toggle fullscreen. .El .Sh CAVEATS .Ss tabbed .obc .It - Using surf with tabbed and hidetabs tabs can conflict with some keybindings. .It \ \ Eg.: Ctrl-m to toggle stylesheet. .It - Some keybindings may conflict with tabbed. .It \ \ Eg.: Ctrl-Shift-[j|k] to zoom in conflicts with moving tabs in tabbed. .It \ \ I have changed the keybinding to zZ for zoomin/out. .El .Sh TODO .obc .It - Translate to Spanish. .It - Check how to copy the url under cursor without using the menu. .It - Check if there is a way to redirect to http when there is no https. .El .Sh SEE ALSO .obc .It .Xr suckless oh , .Xr tabbed oh , .Xr tor oh .It VoidLinux manpages: .Xr surf 1 .It links .It - Lk https://suckless.org/ Suckless.org .It - Lk https://surf.suckless.org/ surf - suckless surf browser .It - Lk https://suckless.org/hacking/ suckless - hacking guidelines .El .Sh HISTORY .obc _______ .It 2026-07-11 Ta : Created. .El .Sh AUTHORS .An -nosplit .Xr ohazot oh | .Xr about oh | .Lk https://ohazot.com ohazot.com .Aq Mt admin@ohazot.com