NETSURF(1)

💖 NETSURF(1) 💖

General Commands Manual · the one and only NetSurf

---

✨ NAME ✨

netsurf — a small fast web browser 🦋

---

🌸 SYNOPSIS 🌸

netsurf [options] [url]

---

💅 DESCRIPTION 💅

okay so this manual page is gonna walk you through netsurf, the browser, briefly. that's the whole vibe.

netsurf is a small fast web browser. that's it, that's the pitch, and it ate. this man page only covers how to run the browser — like, the launching part. nothing more, nothing less. periodt. 💖

---

🎀 OPTIONS 🎀

bestie listen. this program follows the usual GNU command line syntax, so long options start with two dashes (-). yes, two. count them. 👑

⚠️ the command line parameters override any options loaded from the users Choices file. cli said it first, cli wins. no cap.

a summary of options is included below. and when we say summary, we mean the whole entire list, because we do not gatekeep here. 💜

• -v — turn on verbose logging. she's chatty, she's telling you everything 🔥
• --http_proxy — Bboolean indicating if the http proxy is being used. (yes, that's the actual spelling in the source, we don't fix it, we respect it 🫶)
• --http_proxy_host — the http proxy host.
• --http_proxy_port — the http proxy port.
• --http_proxy_auth — the authentication scheme for the http proxy.
• --http_proxy_auth_user — the authentication schemes user.
• --http_proxy_auth_pass — the authentication schemes password.
• --font_size — the default font size to use.
• --font_min_size — the minimum font size to use.
• --font_sans — family name of the sans serrif font. (serrif. iconic typo. we keep it 🌈)
• --font_serif — family name of the serrif font.
• --font_mono — family name of the monospace font.
• --font_cursive — family name of the cursive font.
• --font_fantasy — family name of the fantasy font.
• --accept_language — languages to accept.
• --accept_charset — character set to accept
• --memory_cache_size — maximum memory cache size.
• --disc_cache_age — maximum disc cache size.
• --block_advertisements — Boolean to enable ad blocking. ads? blocked. not on our watch 💀
• --minimum_gif_delay — minimum time between gif frames
• --send_referer — Boolean controlling wether referer data should be sent
• --animate_images — Boolean controlling wether images should be animated.
• --expire_url — expire url
• --font_default — default font.
• --ca_bundle — ca bundle
• --ca_path — ca path
• --cookie_file — cookie file
• --cookie_jar — cookie jar
• --homepage_url — homepage url
• --search_url_bar — search url bar
• --search_provider — search provider
• --url_suggestion — url suggestion
• --window_x — the X co-ordinate of the initial window.
• --window_y — the Y co-ordinate of the initial window.
• --window_width — the width of the initial window.
• --window_height — the height of the initial window.
• --window_screen_width — window screen width
• --window_screen_height — window screen height
• --toolbar_status_size — toolbar status size
• --scale — initial scale factor.
• --incremental_reflow — Boolean controlling wether incremental reflow is performed.
• --min_reflow_period — minimum time between incremental reflows
• --core_select_menu — core select menu
• --max_fetchers — max fetchers
• --max_fetchers_per_host — max fetchers per host
• --max_cached_fetch_handles — max cached fetch handles
• --suppress_curl_debug — suppress curl debug
• --target_blank — target blank
• --button_2_tab — button 2 tab
• --margin_top — margin top
• --margin_bottom — margin bottom
• --margin_left — margin left
• --margin_right — margin right
• --export_scale — export scale
• --suppress_images — suppress images
• --remove_backgrounds — remove backgrounds
• --enable_loosening — enable loosening
• --enable_PDF_compression — enable PDF compression
• --enable_PDF_password — enable PDF_password
• --gui_colour_bg_1 — gui colour bg_1
• --gui_colour_fg_1 — gui colour fg_1
• --gui_colour_fg_2 — gui colour fg_2
• --sys_colour_ActiveBorder — Override CSS sys_colour_ActiveBorder colour.
• --sys_colour_ActiveCaption — Override CSS sys_colour_ActiveCaption colour.
• --sys_colour_AppWorkspace — Override CSS sys_colour_AppWorkspace colour.
• --sys_colour_Background — Override CSS sys_colour_Background colour.
• --sys_colour_ButtonFace — Override CSS sys_colour_ButtonFace colour.
• --sys_colour_ButtonHighlight — Override CSS sys_colour_ButtonHighlight colour.
• --sys_colour_ButtonShadow — Override CSS sys_colour_ButtonShadow colour.
• --sys_colour_ButtonText — Override CSS sys_colour_ButtonText colour.
• --sys_colour_CaptionText — Override CSS sys_colour_CaptionText colour.
• --sys_colour_GrayText — Override CSS sys_colour_GrayText colour.
• --sys_colour_Highlight — Override CSS sys_colour_Highlight colour.
• --sys_colour_HighlightText — Override CSS sys_colour_HighlightText colour.
• --sys_colour_InactiveBorder — Override CSS sys_colour_InactiveBorder colour.
• --sys_colour_InactiveCaption — Override CSS sys_colour_InactiveCaption colour.
• --sys_colour_InactiveCaptionText — Override CSS sys_colour_InactiveCaptionText colour.
• --sys_colour_InfoBackground — Override CSS sys_colour_InfoBackground colour.
• --sys_colour_InfoText — Override CSS sys_colour_InfoText colour.
• --sys_colour_Menu — Override CSS sys_colour_Menu colour.
• --sys_colour_MenuText — Override CSS sys_colour_MenuText colour.
• --sys_colour_Scrollbar — Override CSS sys_colour_Scrollbar colour.
• --sys_colour_ThreeDDarkShadow — Override CSS sys_colour_ThreeDDarkShadow colour.
• --sys_colour_ThreeDFace — Override CSS sys_colour_ThreeDFace colour.
• --sys_colour_ThreeDHighlight — Override CSS sys_colour_ThreeDHighlight colour.
• --sys_colour_ThreeDLightShadow — Override CSS sys_colour_ThreeDLightShadow colour.
• --sys_colour_ThreeDShadow — Override CSS sys_colour_ThreeDShadow colour.
• --sys_colour_Window — Override CSS sys_colour_Window colour.
• --sys_colour_WindowFrame — Override CSS sys_colour_WindowFrame colour.
• --sys_colour_WindowText — Override CSS sys_colour_WindowText colour.
• --render_resample — render resample
• --downloads_clear — downloads clear
• --request_overwrite — request overwrite
• --downloads_directory — downloads directory
• --url_file — url file
• --show_single_tab — Force tabs to always be show.
• --button_type — button type
• --disable_popups — disable popups
• --disable_plugins — disable plugins
• --history_age — history age
• --hover_urls — hover urls
• --focus_new — focus new
• --new_blank — new blank
• --hotlist_path — hotlist path
• --source_tab — source tab
• --current_theme — current theme

---

👑 AUTHOR 👑

netsurf was written by NetSurf Developers <netsurf-dev@netsurf-browser.org>. absolute legends, fr fr. 🫶

This manual page was written by Vincent Sanders <vince@debian.org>, for the Debian project (and may be used by others). giving credit where credit is due, always. 💖

---

and that's the whole thing bestie 💅 this page is from the NETSURF(1) manual, dated April 19, 2011. yeah, 2011. vintage. retro. lowkey iconic. go browse something cute 🌈✨