diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f25d931
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# youtube-dl-gtk
+
+a simple graphical frontend for the `youtube-dl` media downloader.
+
+really just an experiment in creating my first desktop program, so don't expect too much.
+
+uses `gtk-rs`. released under the MIT license.
+
+## features
+
+download from any media source that `youtube-dl` supports (e.g. soundcloud, mixcloud, etc.)
+
+extract audio and convert to mp3 
+
+## known problems
+
+will hang after clicking "go!" due to `youtube-dl` being executed in the same thread. 
+there is no user feedback so this basically looks like the program crashing.