X-Git-Url: https://git.xandkar.net/?a=blobdiff_plain;f=README.md;h=0a75994117ab299664464fcce2b02e30715deb5f;hb=6df41218feef6f9a5fb726a49abfbdf4f80b5030;hp=453f2c60b932a80bd9c5aaea21ca609edb9aab3e;hpb=a7c22aa94654a5e75a8365a0910fbcc03f63343b;p=tt.git

diff --git a/README.md b/README.md
index 453f2c6..0a75994 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,39 @@
+tt
+==
+A more-unixy [twtxt](https://github.com/buckket/twtxt) client.
+
+[![Build Status](https://travis-ci.org/xandkar/tt.svg?branch=master)](https://travis-ci.org/xandkar/tt)
+
+Doesn't force you to maintain a master "following" file (the way Twitter does),
+but let's you point it to any follow-file every time it runs.
+
+This means unlimited possibilities for ad-hoc, interesting filtering
+combinations. Especially when paired with
+[process substitution](https://en.wikipedia.org/wiki/Process_substitution).
+
 ![Screenshot](screenshot-multi.jpg)
+
+
+instructions
+------------
+
+### requirements
+[Racket](https://download.racket-lang.org/)
+
+### installation
+1. Run `make install` or `raco pkg install`
+2. Add `$HOME/.racket/7.9/bin` to your `$PATH`
+   (replacing `7.9` with whatever version you have installed)
+
+### usage
+`tt (FOLLOW-FILE)`
+
+
+notes
+-----
+
+### LWW downloads
+Downloaded timelines are stored in `~/.tt/cache/<SHA1_OF_URI>`, but no attempt
+is made to preserve the previously-downloaded messages - each download
+overrites the previous. One of the implications is that authors can edit/delete
+history without you noticing.