[tt.git] / README.md

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.
Commit	Line	Data
3773a4cd SK	1	tt
3773a4cd SK	2	==
691c20d1	3	A more-unixy [twtxt](https://github.com/buckket/twtxt) client.
3773a4cd	4
6df41218 SK	5	[![Build Status](https://travis-ci.org/xandkar/tt.svg?branch=master)](https://travis-ci.org/xandkar/tt)
6df41218 SK	6
3773a4cd SK	7	Doesn't force you to maintain a master "following" file (the way Twitter does),
	8	but let's you point it to any follow-file every time it runs.
	9
	10	This means unlimited possibilities for ad-hoc, interesting filtering
	11	combinations. Especially when paired with
	12	[process substitution](https://en.wikipedia.org/wiki/Process_substitution).
	13
a7c22aa9	14	![Screenshot](screenshot-multi.jpg)
3773a4cd	15
236a8692	16
3773a4cd SK	17	instructions
	18	------------
	19
	20	### requirements
	21	[Racket](https://download.racket-lang.org/)
	22
	23	### installation
3b0e3842 SK	24	1. Run `make install` or `raco pkg install`
	25	2. Add `$HOME/.racket/7.9/bin` to your `$PATH`
	26	(replacing `7.9` with whatever version you have installed)
3773a4cd SK	27
	28	### usage
	29	`tt (FOLLOW-FILE)`
236a8692 SK	30
	31
	32	notes
	33	-----
	34
	35	### LWW downloads
	36	Downloaded timelines are stored in `~/.tt/cache/<SHA1_OF_URI>`, but no attempt
	37	is made to preserve the previously-downloaded messages - each download
	38	overrites the previous. One of the implications is that authors can edit/delete
	39	history without you noticing.