README.md

About

This is a port of the Netsurf Browser to the Plan 9 (9front) operating system.

This is work in progress, help is welcome.

Important

Ensure that your system is up to date (see FQA#5) as patches to the system are sometimes required to help with porting NetSurf.

Getting the sources

This port is now bundled in the Lael Labs monorepo. Clone https://github.com/lael-labs/netsurf and enter netsurf/src. All required component sources are already present; no separate fetch step is needed. See the root README for the monorepo workflow and UPSTREAM.json for source provenance.

Building / Installing

To build Netsurf, go to the monorepo directory src and run mk:

% cd netsurf/src
% mk
% mk install

Running

First, make sure webfs is running then execute the netsurf binary:

% netsurf

If you did not install NetSurf system-wide (you should), you can run it from within the netsurf directory:

% mk resources/Messages	# create Messages file
% prepns      		# binds 'resources' directory over /sys/lib/netsurf
% *.netsurf   		# runs the binary you compiled (e.g. for your architecture [568])

Credits

The netsurf port is developed and maintained by:

  • phil9 (@telephil9).

Contributors

  • Ori Bernstein (@oridb)
  • Sigrid (@ftrvxmtrx)
  • Michael Forney (@michaelforney)

Historical contributors

  • Jonas Amoson (@jamoson): initial import of netsurf 3.9 sources with framebuffer frontend
  • Kyle Nusbaum (@knusbaum): initial version of webfs fetcher and framebuffer frontend
  • Ori Bernstein (@oridb): setup of build infrastructure and many 9front fixes to have netsurf work