Commit | Line | Data |
---|---|---|
3773a4cd SK |
1 | tt |
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) |
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 | |
6a07fde0 SK |
25 | |
26 | #### manual | |
3773a4cd SK |
27 | [Racket](https://download.racket-lang.org/) |
28 | ||
6a07fde0 SK |
29 | #### package manager |
30 | - Void Linux: `xbps-install racket` | |
31 | - Debian: `apt install racket` | |
32 | ||
3773a4cd | 33 | ### installation |
8676fbce SK |
34 | `make build && make install` will build and copy `tt` binary into |
35 | `$PREFIX/bin`, where `$PREFIX` defaults to `$HOME`. | |
3773a4cd | 36 | |
0b9f3c2c SK |
37 | ### configuration |
38 | Put your `<nick>` and `<uri>` into `~/.tt/me`. For example, mine is: | |
39 | ||
40 | ``` | |
41 | $ cat ~/.tt/me | |
42 | xandkar https://xandkar.net/twtxt.txt | |
43 | ``` | |
44 | It will be used to fill the `User-Agent` header, so that others can tell you're | |
45 | reading their twtxts and perhaps read yours. This isn't strictly necessary and | |
46 | if omitted, you'll stay anonymous. | |
47 | ||
3773a4cd | 48 | ### usage |
58b95fe2 SK |
49 | Download feeds from the Internet: |
50 | `tt d (FOLLOW-FILE)` | |
51 | ||
24f1f64b SK |
52 | Read your timeline: |
53 | `tt r (FOLLOW-FILE)` | |
54 | ||
0b9f3c2c SK |
55 | `FOLLOW-FILE` contains lines with space-separated nick and twtxt.txt URI, like: |
56 | ||
57 | ``` | |
58 | xandkar https://xandkar.net/twtxt.txt | |
59 | ``` | |
60 | ||
24f1f64b SK |
61 | See the rest of the usage options: |
62 | `tt -h` | |
58b95fe2 SK |
63 | |
64 | `tt <command> -h` | |
236a8692 SK |
65 | |
66 | ||
67 | notes | |
68 | ----- | |
69 | ||
70 | ### LWW downloads | |
71 | Downloaded timelines are stored in `~/.tt/cache/<SHA1_OF_URI>`, but no attempt | |
72 | is made to preserve the previously-downloaded messages - each download | |
73 | overrites the previous. One of the implications is that authors can edit/delete | |
74 | history without you noticing. |