SURF(1)

🌸 NAME 🌸

surf — simple webkit-based browser 🦋💅

okay bestie so like, imagine a browser that's just a browser. no tabs, no bloat, no weird sidebar trying to sell you something. that's surf. she's tiny, she's webkit-based, and she is iconic. ✨

---

✨ SYNOPSIS ✨

surf [-bBdDfFgGiIkKmMnNpPsStTvwxX] [-a cookiepolicies] [-c cookiefile]
[-C stylefile] [-e xid] [-r scriptfile] [-u useragent] [-z zoomlevel]
[URI]

like yes, that's a LOT of flags, but don't panic — they're all just lil on/off toggles and a few "here's a file" moments. iykyk 🫶

---

💖 DESCRIPTION 💖

surf is a simple Web browser based on WebKit/GTK+. she can display websites and follow links, which, you know, is the whole job. slay. 🔥

she also supports the XEmbed protocol, which means it's possible to embed her inside another application — yes she can be a little passenger in your bigger app, main character energy in a supporting role, we love versatility. 💅

and furthermore (love a furthermore), you can point surf to another URI by setting its XProperties. so you can yeet her at a new URL from the outside. no cap. 🦋

---

🎀 OPTIONS 🎀

• -a cookiepolicies — Define the order of cookie policies. The default is "@Aa" but could be redefined in the config.h, with "A" meaning to accept all cookies, "a" to deny all cookies and "@", which tells surf to accept no third party cookies. 🍪
• -b — Disable Scrollbars.
• -B — Enable Scrollbars.
• -c cookiefile — Specify the cookiefile to use.
• -C stylefile — Specify the user stylefile. This does disable the site-specific styles. (so like, your CSS ate, but the site's CSS is gone 💀)
• -d — Disable the disk cache.
• -D — Enable the disk cache.
• -e xid — Reparents to window specified by xid.
• -f — Start surf in windowed mode (not fullscreen).
• -F — Start surf in fullscreen mode.
• -g — Disable giving the geolocation to websites.
• -G — Enable giving the geolocation to websites.
• -i — Disable Images.
• -I — Enable Images.
• -k — Disable kiosk mode (enable key strokes and right click).
• -K — Enable kiosk mode (disable key strokes and right click).
• -m — Disable application of user style sheets.
• -M — Enable application of user style sheets.
• -n — Disable the Web Inspector (Developer Tools).
• -N — Enable the Web Inspector (Developer Tools).
• -r scriptfile — Specify the user scriptfile.
• -s — Disable Javascript.
• -S — Enable Javascript.
• -t — Disable strict TLS check.
• -T — Enable strict TLS check.
• -u useragent — Specify the useragent which surf should use.
• -v — Prints version information to standard output, then exits. (she says hi then dips 👋)
• -w — Prints xid to standard output. This can be used to script the browser in for example xdotool(1).
• -x — Disable custom certificates.
• -X — Enable custom certificates.
• -z zoomlevel — Specify the zoomlevel which surf should use.

notice the pattern bestie? lowercase = disable, uppercase = enable. it's giving "one button, two moods" 💅✨

---

🌈 USAGE 🌈

keyboard shortcuts, aka her love language:

• Escape — Stops loading current page or stops download. 🛑
• Ctrl-h — Walks back the history.
• Ctrl-l — Walks forward the history.
• Ctrl-k — Scrolls page upwards.
• Ctrl-j — Scrolls page downwards.
• Ctrl-b — Scroll up one whole page view.
• Ctrl-Space — Scroll down one whole page view.
• Ctrl-i — Scroll horizontally to the right.
• Ctrl-u — Scroll horizontally to the left.
• Ctrl-Shift-k or Ctrl-+ — Zooms page in. 🔍
• Ctrl-Shift-j or Ctrl-- — Zooms page out.
• Ctrl-Shift-q — Resets Zoom.
• Ctrl-f and Ctrl-/ — Opens the search-bar.
• Ctrl-n — Go to next search result.
• Ctrl-Shift-n — Go to previous search result.
• Ctrl-g — Opens the URL-bar (requires dmenu installed).
• Ctrl-p — Loads URI from primary selection.
• Ctrl-Shift-p — Calls Printpage Dialog.
• Ctrl-r — Reloads the website.
• Ctrl-Shift-r — Reloads the website without using the cache. (hard refresh queen 🧚)
• Ctrl-y — Copies current URI to primary selection.
• Ctrl-t — Display the current TLS certificate in a popup window.
• Ctrl-Shift-a — Toggle through the the cookie policies. This will not reload the page.
• Ctrl-Shift-b — Toggle scrollbars. This will reload the page.
• Ctrl-Shift-c — Toggle caret browsing. This will reload the page.
• Ctrl-Shift-d — Toggle dark mode.
• Ctrl-Shift-i — Toggle auto-loading of images. This will reload the page.
• Ctrl-Shift-m — Toggle if the stylefile file should be loaded. This will reload the page.
• Ctrl-Shift-o — Open the Web Inspector (Developer Tools) window for the current page.
• Ctrl-Shift-s — Toggle script execution. This will reload the page.
• Ctrl-Shift-t — Toggle strict TLS check. This will reload the page.
• F11 — Toggle fullscreen mode. 👑

---

👀 INDICATORS OF OPERATION 👀

Surf is showing indicators of operation in front of the site title. For all indicators, unless otherwise specified, a lower case letter means disabled and an upper case letter means enabled. it's a vibe check at a glance, fr fr.

• A — all cookies accepted
• a — no cookies accepted
• @ — all except third-party cookies accepted
• c C — caret browsing
• g G — geolocation
• d D — disk cache
• i I — images
• s S — scripts
• m M — styles
• x X — custom certificates
• t T — strict TLS

---

🦋 INDICATORS OF WEB PAGE 🦋

The second part of the indicators specifies modes of the web page itself. yes she has layers. 💅

First character: encryption

• - — unencrypted
• T — encrypted (TLS)
• U — attempted encryption but failed

Second character: proxying

• - — no proxy
• P — using proxy

---

🌱 ENVIRONMENT 🌱

• http_proxy — If this variable is set and not empty upon startup, surf will use it as the http proxy.

---

📣 SIGNALS 📣

Surf will reload the current page on SIGHUP.

---

🔗 SEE ALSO 🔗

dmenu(1), xprop(1), tabbed(1), xdotool(1)

---

🐛 BUGS 🐛

Please report them! (she's not mad, she just wants to grow 🫶✨)

---

and that's the whole page bestie, no notes, you understood all of it, i'm so proud of you 💖✨🎀

this lil manual is from surf-2.1 — so like, go forth, browse simple, stay iconic. periodt. 👑💅🌸