pulsarss/README.md
2025-02-12 19:18:12 +02:00

1.8 KiB

pulsarss

Build Dependencies crates.io

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

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.gmi files (false 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

# /etc/systemd/system/pulsarss.service

[Unit]
After=network.target

[Service]
Type=simple
User=pulsarss
Group=pulsarss
ExecStart=pulsarss -is https://path/to/feed.rss

[Install]
WantedBy=multi-user.target
  • systemctl daemon-reload - reload systemd configuration
  • systemctl enable pulsarss - enable service on system startup
  • systemctl start pulsarss - start server