diff --git a/README.md b/README.md
index bcd2c66..8e093c2 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,37 @@
 # tetris
+
+A terminal interface for Tetris
+
+![terminal-gif](./docs/img/play.gif)
+
+## installation
+
+For Mac and Linux, the binaries attached to the GitHub release should suffice.
+Here is a quick way to get the one for your OS:
+```bash
+curl -L https://github.com/samtay/tetris/releases/download/0.1.0/tetris-`uname -s`-`uname-m` | sudo tee /usr/local/bin/tetris
+sudo chmod +x /usr/local/bin/tetris
+```
+
+For Windows, you have to install from source. First [get stack](https://docs.haskellstack.org/en/stable/README/#how-to-install). Then
+```bash
+git clone https://github.com/samtay/tetris.git
+cd tetris
+stack install tetris
+```
+
+## screenshots
+
+#### Linux termite - tomorrow night eighties
+![linux-tomorrow-night-80s](./docs/img/linux_tomorrow_night_80s.png)
+#### Mac terminal - plain
+![mac-terminal-plain](./docs/img/mac_plain.png)
+#### Mac terminal - grass
+![mac-terminal-grass](./docs/img/mac_grass.png)
+
+## todo
+
+1. Leaderboard saved to txt file (requires adding brick viewport for name entry)
+and probably wrapping game in a ui state type
+2. Use linear V2 instead of tuples.. dummy
+3. Consider refactoring (Game -> a) types with State or Reader abstraction
diff --git a/docs/img/linux_tomorrow_night_80s.png b/docs/img/linux_tomorrow_night_80s.png
new file mode 100644
index 0000000..404ffdd
Binary files /dev/null and b/docs/img/linux_tomorrow_night_80s.png differ
diff --git a/docs/img/play.gif b/docs/img/play.gif
new file mode 100644
index 0000000..0d4cfea
Binary files /dev/null and b/docs/img/play.gif differ
diff --git a/src/Tetris.hs b/src/Tetris.hs
index 464ae7a..fa08959 100644
--- a/src/Tetris.hs
+++ b/src/Tetris.hs
@@ -17,14 +17,6 @@ import Data.Bool (bool)
 import Data.Maybe (fromMaybe)
 import Data.Monoid (First(..))
 
--- TODO
---   1. leaderboard saved to txt file (requires adding viewport for name entry)
---      and probably wrapping game in a ui state
---   2. USE linear V2 instead of tuples.. dummy
---   3. Consider refactoring (Game -> a) with State or Reader abstraction
---   4. README with gif
---   5. release binaries for darwin and linux
-
 -- Types and instances
 
 -- | Tetris shape types