Home

Awesome

rsslay

CI Build & Test Fly Deploy CI Dive Check Publish Docker image codecov

Docker Hub FOSSA Status

Go Report Card Go Reference

Nostr relay that creates virtual nostr profiles for each RSS feed submitted based on relayer by fiatjaf.

Donate for development ⚡: https://getalby.com/p/piraces

Working relay: wss://rsslay.nostr.moe. Frontend available in rsslay.nostr.moe.

Deploy on Railway

Screenshot of main page

API

rsslay exposes an API to work with it programmatically, so you can automate feed creation and retrieval. Checkout the wiki entry for further info.

Mirroring events ("replaying")

Note: since v0.5.3 its recommended to set REPLAY_TO_RELAYS to false. There is no need to perform replays to other relays, the main rsslay should be able to handle the events.

Actually rsslay makes usage of a method named AttemptReplayEvents which is made to send the events to other relays of confidence to attempt to make the events and the profile more reachable (they are just mirror relays)...

Currently used relays: none.

Feeds from Twitter via Nitter instances

The Nitter project is well integrated into rsslay and it performs special handling of this kind of feeds. Currently rsslay is doing the following with Nitter feeds:

Running the project

Running rsslay its easy, checkout the wiki entry for it.

Deploying your instance

If you want to run your own instance, you are covered! Several options (including "one-click" ones) are available. Checkout the wiki.

Caching

Since version v0.5.1, rsslay uses cache by default (in-memory with BigCache by default or with Redis if configured) enabled by default to improve performance. In the case of the main instance rsslay.nostr.moe, Redis is used in HA mode to improve performance for multiple requests for the same feed.

Nevertheless, there is a caveat using this approach that is that cached feeds do not refresh for 30 minutes (but I personally think it is worth for the performance gain).

Metrics

Since version v0.5.1, rsslay uses Prometheus instrumenting with metrics exposed on /metrics path. So with this you can mount your own Graphana dashboards and look into rsslay insights!

Related projects

Contributing

Feel free to open an issue, provide feedback in discussions, or fork the repo and open a PR with your contribution!

All kinds of contributions are welcome!

Contact

You can reach me on nostr npub1ftpy6thgy2354xypal6jd0m37wtsgsvcxljvzje5vskc9cg3a5usexrrtq

Also on the bird site, and Mastodon.

License

Unlicense.

FOSSA Status