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

pulsarss --help

Autostart

systemd

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

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

Create systemd configuration file:

# /etc/systemd/system/pulsarss.service

[Unit]
After=network-online.target
Wants=network-online.target

[Service]
Type=simple

User=pulsarss
Group=pulsarss

# Uncomment for debug
# Environment="RUST_LOG=debug"
# Environment="NO_COLOR=1"

ExecStart=/usr/local/bin/pulsarss -s https://path/to/feed.rss -i index.gmi

StandardOutput=file:///home/pulsarss/debug.log
StandardError=file:///home/pulsarss/error.log

[Install]
WantedBy=multi-user.target

example above requires new system user (useradd -m pulsarss)

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 KiB Raw Blame History