diff --git a/README.md b/README.md
new file mode 100644
index 0000000..058b787
--- /dev/null
+++ b/README.md
@@ -0,0 +1,20 @@
+kino
+====
+
+kino is a tui client for browsing yts.mx
+
+usage
+-----
+
+use the arrows or hjkl to scroll entries and switch page
+
+use s or '/' to search for a movie
+
+use space or enter to open/close details for the selected entry
+
+use keys 1 through 9 to copy the magnet link with the same number in the details for the movie
+
+legal
+-----
+
+this program does nothing else than to display the contents of yts.mx in a terminal. it does not upload or download any files. it does not enable illegal redistrubution any more than a web browser.