diff --git a/readme b/readme
new file mode 100644
index 0000000..f0151b1
--- /dev/null
+++ b/readme
@@ -0,0 +1,22 @@
+rose browser
+------------
+
+Simple webkitgtk browser.
+
+requirements
+------------
+
+In order to build surf you need gtk4 and webkit2gtk-5.0.
+
+In order to use the functionalities:
+  - video support: gst-libav, gst-plugins-good
+  - url bar: dmenu
+  - tabs: tabbed
+
+installation
+------------
+
+Run following command to build and install
+(if necessary as root):
+
+  make clean install