SURF(oh)			     LOCAL			      SURF(oh)

surf - suckless web browser - usage

COMPILE
     Surf uses webkit2gtk-4.1.	The file config.mk can be changed to use
     webkit2gtk-4.0 if 4.1 is not available.

PATCHES
     I have not found the need to use any patches yet.	This section will be
     updated if any patches are tested.

STYLES
     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.

OPTIONS
     -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.

   Toggles
     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.

KEYBINDINGS
     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.

CAVEATS
   tabbed
     - 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.

TODO
     - 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.

SEE ALSO
     suckless(oh), tabbed(oh), tor(oh)
     VoidLinux manpages: surf(1)
     links
     - Suckless.org: https://suckless.org/
     - surf - suckless surf browser: https://surf.suckless.org/
     - suckless - hacking guidelines: https://suckless.org/hacking/

HISTORY
     2026-07-11 : Created.

AUTHORS
     ohazot(oh) | about(oh) | ohazot.com: https://ohazot.com
     <admin@ohazot.com>

Linux OpenBSD |			  2026-07-11			      SURF(oh)