README and GIF

Author: passy

README.md

@@ -2,9 +2,48 @@
 
 [![Build Status](https://travis-ci.org/passy/givegif.svg?branch=master)](https://travis-ci.org/passy/givegif)
 
-**Work In Progress**
+**WARNING: Some of the steps in the readme don't quite reflect reality yet.**
 
-> Find and display GIFs on the command line.
+> Find and display GIFs from the command line.
+
+## Demo
+
+![](media/usage.gif)
+
+## Usage
+
+```
+Usage: givegif [-n|--no-preview] ([-s|--search ARG] | [-t|--translate ARG] |
+               [RANDOM_TAG])
+  Find GIFs on the command line.
+
+Available options:
+  -h,--help                Show this help text
+  -n,--no-preview          Don't render an inline image preview.
+  -s,--search ARG          Use search to find a matching GIF.
+  -t,--translate ARG       Use translate to find a matching GIF.
+  -V,--version             Show version information
+```
+
+## Installation
+
+Check out the latest [releases](https://github.com/passy/givegif/releases) for
+precompiled binaries.
+
+Alternatively, feel free to build it yourself with
+[stack](http://haskellstack.org).
+
+
+```bash
+$ stack install givegif
+$ givegif -V
+givegif 1.0.0.0
+```
+
+## Known Issues
+
+Even though I tried to make this work with screen/tmux, it still glitches out
+every now and then. If you can figure out why, please let me know.
 
 ## License