3 files changed, 43 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3303eb5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+Low Battery Yup
+===============
+
+When a Mac laptop is low on battery, Mac OS X will kindly show an alert dialog
+to make the user aware of this. Mac OS X will unkindly pop that dialog on top of
+all other windows _without_ making it the key window, thus rendering it
+impossible to dismiss using the keyboard alone. Instead, users must mouse to the
+window in order to make it go away.
+
+Low Battery Yup is a daemon that will click the low battery alert dialog's OK
+button when a keyboard shortcut is pressed, eliminating the need to use the
+mouse. This allows you to say “Yup, thanks for letting me know. You can go away
+now, just don't force me to reach for the mouse”.
+
+The global shortcut that activates the pressing of the OK button is
+configurable.
+
+
+## Demo
+![Screencast](./screenshots/Demo.gif)
+
+
+## Configuration Screenshot
+![Configuration](./screenshots/Configuration.png)
+
+
+## Install
+A copy of the application bundle is available on the [releases][1] page. Unzip
+it and drag it to your `/Applications` folder.
+
+
+## Uninstall
+Open Low Battery Yup. If the button reads “Quit Application”, click it. Uncheck
+the “Start at login” check box. Quit and trash Low Battery Yup and its
+`~/Library/Preferences` plist file.
+
+
+## License
+Copyright © 2016 Teddy Wing. Licensed under the GNU GPLv3+ (see the included
+COPYING file).
+
+
+[1]: https://github.com/teddywing/Low-Battery-Yup/releases
diff --git a/screenshots/Configuration.png b/screenshots/Configuration.png
new file mode 100644
index 0000000..d1084fb
--- /dev/null
+++ b/screenshots/Configuration.png
diff --git a/screenshots/Demo.gif b/screenshots/Demo.gif
new file mode 100644
index 0000000..f044419
--- /dev/null
+++ b/screenshots/Demo.gif