Skip to content

Randoragon's fork of surf - the suckless internet browser

License

Notifications You must be signed in to change notification settings

randoragon/surf

Repository files navigation

surf - simple webkit-based browser

surf is a simple Web browser based on WebKit/GTK+.

My build of surf, the feather-weight and simple web browser made by suckless. See the original website at surf.suckless.org

Features

  • add/remove bookmarks (one per line in ~/.config/surf/bookmarks)
  • custom search engines (prefixes)
  • search in duckduckgo by prefixing a query with '`'
  • use XA_CLIPBOARD instead of XA_PRIMARY for C-y and C-p operations
  • spawn download history in a terminal with
  • edit page source in $EDITOR
  • follow links with keyboard shortcuts + dmenu
  • open links in the default browser (xdg-open)

Applied Patches

Some patches may have been modified by me to suit my needs better.

Requirements

In order to build surf you need GTK+ and Webkit/GTK+ header files.

In order to use the functionality of the url-bar, also install dmenu[0].

Installation

Edit config.mk to match your local setup (surf is installed into the /usr/local namespace by default).

Afterwards enter the following command to build and install surf (if necessary as root):

make clean install

Running surf

run surf [URI]

See the manpage for further options.