[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).

### long format (default)
![Screenshot](screenshot-long.jpg)

### short format (CLI option: -s)
![Screenshot](screenshot-short.jpg)


instructions
------------

### requirements
[Racket](https://download.racket-lang.org/)

### installation
`make build && make install` will build and copy `tt` binary into `$PREFIX/bin`.

### usage
Download feeds from the Internet:
`tt d (FOLLOW-FILE)`

Read your timeline:
`tt r (FOLLOW-FILE)`

See the rest of the usage options:
`tt -h`

`tt <command> -h`


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
01e4c499 SK	14	### long format (default)
	15	![Screenshot](screenshot-long.jpg)
	16
	17	### short format (CLI option: -s)
	18	![Screenshot](screenshot-short.jpg)
3773a4cd	19
236a8692	20
3773a4cd SK	21	instructions
	22	------------
	23
	24	### requirements
	25	[Racket](https://download.racket-lang.org/)
	26
	27	### installation
3c9c8266	28	`make build && make install` will build and copy `tt` binary into `$PREFIX/bin`.
3773a4cd SK	29
3773a4cd SK	30	### usage
58b95fe2 SK	31	Download feeds from the Internet:
	32	`tt d (FOLLOW-FILE)`
	33
24f1f64b SK	34	Read your timeline:
	35	`tt r (FOLLOW-FILE)`
	36
	37	See the rest of the usage options:
	38	`tt -h`
58b95fe2 SK	39
58b95fe2 SK	40	`tt <command> -h`
236a8692 SK	41
	42
	43	notes
	44	-----
	45
	46	### LWW downloads
	47	Downloaded timelines are stored in `~/.tt/cache/<SHA1_OF_URI>`, but no attempt
	48	is made to preserve the previously-downloaded messages - each download
	49	overrites the previous. One of the implications is that authors can edit/delete
	50	history without you noticing.