pulsarss/README.md
2025-02-11 20:29:14 +02:00

1.8 KiB

pulsarss

Build Dependencies crates.io

RSS Aggregator for Gemini Protocol

pulsarss is a multi-process crawler for RSS feeds. It collects the data into static gemtext files, organized in sub-folders by pub_date; also builds an actual index.gmi file in the destination folders for easy reading in your favorite Gemini browser.

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

Options

  • source, s - RSS feed source (required)
  • target, t - Destination directory (public by default)
  • update, u - Update timeout in seconds (60 by default)
  • output, o - Print output (d by default):
    • d - debug
    • n - disable

Autostart

systemd

# /etc/systemd/system/pulsarss.service

[Unit]
After=network.target

[Service]
Type=simple
User=pulsarss
Group=pulsarss
ExecStart=pulsarss -s 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