diff --git a/README.md b/README.md
index 2f815fe..8a6c7d8 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,19 @@
 # Kaomoji Rofi
+
+Rofi script for typing kaomojis.
+![Kaomoji Rofi Preview](ss.png)
+
+## Requirements
+
++ `rofi`
++ `xdotool`
+
+## Installation
+
++ `git clone https://gitlab.com/ceda_ei/kaomoji-rofi`
++ Add a keybinding to run `/path/where/you/cloned/kaomoji-rofi/kaomoji.sh`
+
+## Configuration
+
+All options passed to kaomoji.sh are passed to rofi. The screenshot has been
+taken with the following command. `kaomoji.sh -config config -theme some_theme.rasi`
diff --git a/config b/config
new file mode 100644
index 0000000..b4b7851
--- /dev/null
+++ b/config
@@ -0,0 +1,6 @@
+rofi.width: 100
+rofi.lines: 11
+rofi.columns: 5
+rofi.fullscreen: true
+rofi.hide-scrollbar: true
+rofi.location: 0
diff --git a/kaomoji.sh b/kaomoji.sh
index 1297a46..ed25656 100755
--- a/kaomoji.sh
+++ b/kaomoji.sh
@@ -1,3 +1,5 @@
+#!/usr/bin/env bash
+
 selection=$(rofi -i -dmenu $@ < $(dirname $0)/kaomoji.txt)
 kaomoji=$(echo $selection | sed "s|$(echo -e "\ufeff").*||")
 xdotool type --clearmodifiers "$kaomoji"
diff --git a/ss.png b/ss.png
new file mode 100644
index 0000000..ae90211
Binary files /dev/null and b/ss.png differ