Dedup read-in peers before using them
[tt.git] / README.md
... / ...
CommitLineData
1tt
2==
3A more-unixy [twtxt](https://github.com/buckket/twtxt) client.
4
5[![Build Status](https://travis-ci.org/xandkar/tt.svg?branch=master)](https://travis-ci.org/xandkar/tt)
6
7Doesn't force you to maintain a master "following" file (the way Twitter does),
8but let's you point it to any follow-file every time it runs.
9
10This means unlimited possibilities for ad-hoc, interesting filtering
11combinations. Especially when paired with
12[process substitution](https://en.wikipedia.org/wiki/Process_substitution).
13
14### long format (default)
15![Screenshot](screenshot-long.jpg)
16
17### short format (CLI option: -s)
18![Screenshot](screenshot-short.jpg)
19
20
21instructions
22------------
23
24### requirements
25
26#### manual
27[Racket](https://download.racket-lang.org/)
28
29#### package manager
30- Void Linux: `xbps-install racket`
31- Debian: `apt install racket`
32
33### installation
34`make build && make install` will build and copy `tt` binary into
35`$PREFIX/bin`, where `$PREFIX` defaults to `$HOME`.
36
37### configuration
38Put your `<nick>` and `<uri>` into `~/.tt/me`. For example, mine is:
39
40```
41$ cat ~/.tt/me
42xandkar https://xandkar.net/twtxt.txt
43```
44It will be used to fill the `User-Agent` header, so that others can tell you're
45reading their twtxts and perhaps read yours. This isn't strictly necessary and
46if omitted, you'll stay anonymous.
47
48### usage
49Download feeds from the Internet:
50`tt d (FOLLOW-FILE)`
51
52Read your timeline:
53`tt r (FOLLOW-FILE)`
54
55`FOLLOW-FILE` contains lines with space-separated nick and twtxt.txt URI, like:
56
57```
58xandkar https://xandkar.net/twtxt.txt
59```
60
61See the rest of the usage options:
62`tt -h`
63
64`tt <command> -h`
65
66
67notes
68-----
69
70### LWW downloads
71Downloaded timelines are stored in `~/.tt/cache/<SHA1_OF_URI>`, but no attempt
72is made to preserve the previously-downloaded messages - each download
73overrites the previous. One of the implications is that authors can edit/delete
74history without you noticing.
This page took 0.026762 seconds and 4 git commands to generate.