Skip to content

Latest commit

 

History

History
54 lines (41 loc) · 1.47 KB

README.md

File metadata and controls

54 lines (41 loc) · 1.47 KB

surf - simple webkit-based browser

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

Custom features

  • Use ~/.config, ~/.local/share and ~/.cache for config, data and cache files.
  • Use rofi instead of dmenu for interactive prompts.
  • Use notify-send to send status messages regarding downloads.
  • More vim-like keybinds (see updated manpage).
  • Use duckduckgo.com as a homepage.
  • Specify a custom download directory.
  • Simple history for visited websites.
  • Hotkey to play video and audio in external player.
  • Add search through duckduckgo.com with history.

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.

Running surf in tabbed

For running surf in tabbed[1] there is a script included in the distribution, which is run like this:

surf-open.sh [URI]

Further invocations of the script will run surf with the specified URI in this instance of tabbed.

[0] http://tools.suckless.org/dmenu [1] http://tools.suckless.org/tabbed