aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README19
1 files changed, 12 insertions, 7 deletions
diff --git a/README b/README
index da4577f..4553e3d 100644
--- a/README
+++ b/README
@@ -2,6 +2,8 @@ surf - simple webkit-based browser
==================================
surf is a simple Web browser based on WebKit/GTK+.
+surf runs as a native Wayland client, it does not build or run on X11.
+
Requirements
------------
In order to build surf you need GTK+ and Webkit/GTK+ header files.
@@ -25,16 +27,19 @@ run
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:
+Controlling a running surf
+--------------------------
+Every surf window creates a control fifo in $XDG_RUNTIME_DIR/surf. Writing a
+line to it makes that window load a URI or search the page:
+
+ printf 'uri %s\n' https://suckless.org >"$XDG_RUNTIME_DIR"/surf/*
+
+See the CONTROL FIFO section of the manpage. The included script
surf-open.sh [URI]
-Further invocations of the script will run surf with the specified URI in this
-instance of tabbed.
+uses this to hand the URI to an already running surf, and only starts a new
+one if there is none.
[0] http://tools.suckless.org/dmenu
-[1] http://tools.suckless.org/tabbed