diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e884b58
--- /dev/null
+++ b/README.md
@@ -0,0 +1,67 @@
+Workstyle
+===
+
+Sway/i3 workspaces with style:
+
+This application will dynamically rename your workspaces to indicate which programs are running in each one.
+
+A picture is better than a thousand words!
+
+* The workspace bar could look like this (uses waybar)
+![alt tag](https://github.com/pierrechevalier83/workstyle/blob/master/screenshots/bar.png)
+
+* In context:
+![alt tag](https://github.com/pierrechevalier83/workstyle/blob/master/screenshots/full.png)
+
+Installation
+===
+
+```
+cargo install workstyke
+```
+
+Usage
+===
+
+Simply run the executable:
+```
+workstyle
+```
+
+```
+workspace --help
+```
+will give you some more context.
+
+Sway configuration
+===
+
+Add this line to your sway config:
+```
+exec "workstyle &> /tmp/workstyle.log"
+```
+
+You may also want to control the log level with the environment variable: RUST_LOG to error, info or debug.
+
+Note that since your workspaces will be renamed all the time, you should configure your keybindings to use numbered workspaces instead of assuming that the name is the number:
+Prefer
+```
+    bindsym $mod+1 workspace number 1
+```
+over
+```
+    bindsym $mod+1 workspace 1
+```
+
+Configuration
+===
+
+The main configuration consists of deciding which icons to use for which applications.
+
+The config file is located at `${XDG_CONFIG_HOME}/workstyle/config.yml`. It will be generated if missing. Read the generated file. The syntax is in YAML and should be pretty self-explanatory.
+
+When an app isn't recogised in the config, `workstyle` will log the application name as an error.
+Simply add that string (case insensitive) to your config file, with an icon of your choice.
+
+Note that the crate [`find_unicode`](https://github.com/pierrechevalier83/find_unicode/) can help find a unicode character directly from the command line. It now supports all of nerdfonts unicode space.
+
diff --git a/TODO.md b/TODO.md
index 3ecca66..807a88a 100644
--- a/TODO.md
+++ b/TODO.md
@@ -1,4 +1,3 @@
 More logging
 Decide if I want to pursue something more robust than the app name using the app id
-README
 publish crate
diff --git a/screenshots/bar.png b/screenshots/bar.png
new file mode 100644
index 0000000..2206728
Binary files /dev/null and b/screenshots/bar.png differ
diff --git a/screenshots/full.png b/screenshots/full.png
new file mode 100644
index 0000000..0d88dda
Binary files /dev/null and b/screenshots/full.png differ
diff --git a/src/default_config.yml b/src/default_config.yml
index fec89c8..b6690c2 100644
--- a/src/default_config.yml
+++ b/src/default_config.yml
@@ -29,4 +29,3 @@
 - [music, ]
 - [disk usage, ]
 - [.pdf, ]
-- ["", " "]