diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..800e66b
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,12 @@
+# timeout.sh
+Requires libnotify-bin on Debian. On non-Debian distros you should be able to install notify-send and remove the libnotify-bin check and it might work.
+## Usage
+I have timeout in my .local/bin directory and call it in my .profile.
+```
+timeout.sh [seconds] [message]
+```
+eg
+```
+timeout.sh 20 "Hey, should you take a break?"
+```
+