yggverse/pulsar

RSS Aggregator for Gemini Protocol

dev-main 2024-04-27 18:56 UTC

This package is auto-updated.

Last update: 2024-04-27 18:56:10 UTC


README

RSS Aggregator for Gemini Protocol

Simple RSS feed converter to static Gemtext format, useful for news portals or localhost reading

Example

  • nex://[301:23b4:991a:634d::feed]/index.gmi - Yggdrasil instance by YGGverse

Usage

  1. git clone https://github.com/YGGverse/Pulsar.git
  2. cp example/config.json config.json - setup your feed locations
  3. php src/crawler.php - grab feeds manually or using crontab

Config

Configuration file supports multiple feed channels with custom settings:

  • source - string, filepath or URL to the valid RSS feed
  • target - string, relative or absolute path to Gemtext dumps
  • item
    • limit - integer, how many items to display on page generated
    • template - string, custom pattern for feed item, that supports following macros
      • {nl} - new line separator
      • {link} - item link
      • {guid} - item guid
      • {pubDate} - item pubDate, soon with custom time format e.g. {pubDate:Y-m-d H:s}
      • {title} - item title
      • {description} - item description

Resulting files could be placed to any local folder (for personal reading) or shared with others (using gmid, twins or any other server for gemtext statics)