about summary refs log tree commit diff stats
path: root/README
blob: f946bed25151653586d47fa0ad6c5b6ebf6c6c9b (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
                               ━━━━━━━━━
                                 PYXIS

                                Andinus
                               ━━━━━━━━━


Pyxis is a simple twtxt client.

[twtxt] is a decentralised, minimalist microblogging service for
hackers.


[twtxt] https://github.com/buckket/twtxt


1 Documentation
═══════════════

  Pyxis can only follow feeds currently. I'm writing this for fun, more
  features will be added if I use it.

  The feeds are saved in `$XDG_DATA_HOME/pyxis', if it's not defined
  then `$HOME/.local/share/pyxis' is used. Feeds are configured in
  `$XDG_CONFIG_HOME/pyxis.pl' or `$HOME/.config/pyxis.pl'.


1.1 Configuration
─────────────────

  There is an example config file under `share/config.pl', move it
  config directory & rename it to `pyxis.pl'.

  *Warning*: Pyxis will evaluate the configuration file, which means an
  attacker can use it to run malicious code.

  *Note*: They could always add malicious code to `.profile' & do harm.
  Just thought I should put the warning.

  ┌────
  │ #!/usr/bin/perl
  │
  │ use strict;
  │ use warnings;
  │
  │ my %feeds = (
  │     example => "https://example.com/twtxt.txt",
  │ );
  │
  │ sub get_feeds { return %feeds; }
  │
  │ 1;
  └────

  Add your feeds to `%feeds' hash like shown above. You can remove those
  2 `use' lines but it's good if you keep them.