diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8ed08fa..1a3bd70 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,7 @@ All notable changes are documented in this file using the [Keep a CHANGELOG](htt
 * Added: Switch Project command
 * Added: Remove Folder command
 * Doc: Setup guide
+* Doc: Setup key bindings
 
 ### Deprecated
 
diff --git a/README.md b/README.md
index b3c2ae5..7e627af 100644
--- a/README.md
+++ b/README.md
@@ -59,9 +59,26 @@ Open Sesame: Switch Project | `open_sesame_switch_project` | Add a project to th
 
 ## Key bindings
 
-OS X | Windows / Linux | Description
------|-----------------|------------
-`Super+Alt+o` | `Ctrl+Alt+o` | Open Sesame: Open Project
+Windows / Linux | OSX | Description
+--------------- | --- | -----------
+`Ctrl+Alt+O` | `Super+Alt+O` | Open Sesame: Open Project
+
+Add your preferred key bindings:
+
+`Menu > Preferences > Key Bindings`
+
+```json
+[
+    { "keys": ["ctrl+alt+a"], "command": "open_sesame_add_project" },
+    { "keys": ["ctrl+alt+o"], "command": "open_sesame_open_project" },
+    { "keys": ["ctrl+alt+r"], "command": "open_sesame_remove_folder" },
+    { "keys": ["ctrl+alt+s"], "command": "open_sesame_switch_project" },
+]
+```
+
+On Ubuntu you may have conflict issues with key bindings such as `ctrl+alt+s` that may be mapped to something like the system `toggle-shaded` window command. You can clear the system keybinding with a command at terminal. If you have issues with key bindings on Ubuntu, ping me on twitter and I'll do my best to help you resolve it.
+
+    $ gsettings set org.gnome.desktop.wm.keybindings toggle-shaded "[]"
 
 ## Configuration