diff --git a/README.md b/README.md
index 4199b77c3..f6654af6b 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,26 @@ you'll need [homebrew](http://brew.sh/) to install the required dependencies.
 - `cd bin`
 - `./musikbox`
 
+## keyboard shortcuts
+
+the user interface is very new and will change considerably over time.
+
+the current hotkeys are generally based around holding the alt/meta key with your left thumb, and using the home row with your right hand. 
+
+- `<TAB>` tabs between windows
+- `F1` switch to console view
+- `F2` switch to library view
+- `ALT+i` volume up 5%
+- `ALT+k` volume down 5%
+- `ALT+j` previous track
+- `ALT+l` next track
+- `ALT+u` back 10 seconds
+- `ALT+o` forward 10 seconds
+- `ALT+r` repaint the screen
+- `<SPACE>` pause/resume (only in library view)
+- `CTRL+p` pause/resume (globally)
+- `CTRL+d` quit 
+
 # sdk
 
-musikcube is built around its SDK interfaces. they're still in the process of being cleaned up and slimmed down. you can see what they look like here: https://github.com/clangen/musikcube/tree/master/src/core/sdk
+musikcube is built around its own SDK interfaces. they're still in the process of being cleaned up and slimmed down. you can see what they look like here: https://github.com/clangen/musikcube/tree/master/src/core/sdk