surf

Surf web browser.
git clone git://r-36.net/surf
Log | Files | Refs | README | LICENSE

README (1346B)


      1 surf - simple webkit-based browser
      2 ==================================
      3 surf is a simple Web browser based on WebKit/GTK+.
      4 
      5 Requirements
      6 ------------
      7 In order to build surf you need GTK+ and Webkit/GTK+ header files.
      8 
      9 In order to use the functionality of the url-bar, also install dmenu[0].
     10 
     11 Surf is running a "download" script when a file needs to be downloaded and a
     12 "plumb" script when some URI needs to be opened, which is not beginning with
     13 "about:", "http://" or "https://". Please create them in your $PATH prior to
     14 using surf.
     15 
     16 An example file for the User-Agent switching file is supplied in
     17 "useragents.txt". You may need to adapt them to the current world situation.
     18 
     19 Installation
     20 ------------
     21 Edit config.mk to match your local setup (surf is installed into
     22 the /usr/local namespace by default).
     23 
     24 Afterwards enter the following command to build and install surf (if
     25 necessary as root):
     26 
     27     make clean install
     28 
     29 Running surf
     30 ------------
     31 run
     32 	surf [URI]
     33 
     34 See the manpage for further options.
     35 
     36 Running surf in tabbed
     37 ----------------------
     38 For running surf in tabbed[1] there is a script included in the distribution,
     39 which is run like this:
     40 
     41 	surf-open.sh [URI]
     42 
     43 Further invocations of the script will run surf with the specified URI in this
     44 instance of tabbed.
     45 
     46 [0] http://tools.suckless.org/dmenu
     47 [1] http://tools.suckless.org/tabbed
     48