pulsarss

RSS Aggregator for Gemini Protocol

pulsarss is a multi-process crawler for RSS feeds, that collects and converts results into the static gemtext files; also aggregates an actual index.gmi file in the relevant folders organized by channel / item pub_date.

Note

At this moment, pulsarss does not provide any built-in server. To read the data collected, use any server for static files listed in the awesome-gemini

Install

cargo install pulsarss

Launch

pulsarss --source https://path/to/feed.rss --index index.gmi

Options

source, s - RSS feed source (required)
target, t - Destination directory (public by default)
update, u - Update timeout in seconds (60 by default)
index, i - Generate index files with given filename (disabled by default)
limit, l - Limit channel items (unlimited by default)
output, o - Print output (dw by default):
- d - debug
- w - warning
- n - disable

Autostart

systemd

Install pulsarss by copy the binary compiled into the system destination:

Linux: sudo cp /home/user/.cargo/bin/pulsarss /usr/local/bin

Create systemd configuration file:

# /etc/systemd/system/pulsarss.service

[Unit]
After=network.target

[Service]
Type=simple
User=pulsarss
Group=pulsarss
ExecStart=pulsarss -s https://path/to/feed.rss -i index.gmi

[Install]
WantedBy=multi-user.target

Run in priority:

systemctl daemon-reload - reload systemd configuration
systemctl enable pulsarss - enable new service
systemctl start pulsarss - start the process
systemctl status pulsarss - check process launched

2.1 KiB Raw Blame History