# RSSHub

RSSHub is a community-maintained RSS gateway that exposes feeds for sites and services that don't publish their own. Over 1,300 contributors, several thousand routes built in, AGPL-licensed, with a heavy ecosystem of public instances and downstream integrations.

## What it does

Each "route" is a small handler that scrapes or wraps an upstream source — a forum, a news site, a social account, an aggregation page — and returns an RSS/Atom/JSON Feed. The routes are first-class citizens: the project encourages adding new ones and ships hundreds organized by source.

## Architecture

- TypeScript over Node.js (or Bun).
- Per-source route definitions in a flat directory tree, importable as plug-ins.
- Cache layer (Redis or in-memory) to absorb upstream rate limits.
- Both self-hosted and run as public instances; AGPL forces self-hosters who modify and serve it to publish their changes.

## How to use

A typical use is to run an instance somewhere (Docker, Vercel, a VPS) and point a feed reader at it. For example:

- `https://your-rsshub.example.com/twitter/user/jxnl` — a Twitter account as RSS.
- `https://your-rsshub.example.com/github/issue/owner/repo` — a repo's open issues as RSS.

Hundreds of categories exist. The docs at `docs.rsshub.app` are the canonical route index.

## Companions

The piece points at [Folo](https://folo.is/) as the AI RSS reader RSSHub is built to integrate with — smarter discovery, shared instances, modern reading workflows. The two together form the modern equivalent of Google Reader.

## Where it sits

Adjacent to [[coywolf-byline-rss]] and [[byline-spec]] — the RSS-renaissance cluster. Where Byline is about adding structured author identity to feeds, RSSHub is about generating feeds in the first place for sources that have stopped publishing them. The combination is what makes RSS-as-an-aggregation-layer plausible again in 2026.

[[gallery-dl]] runs the same maintenance model on a different payload: hundreds of hand-written per-site extractors instead of per-site feed routes, kept alive by a community that re-fixes them every time a platform changes its markup or its auth. Both projects exist because the sites in question stopped offering a machine-readable way out, and both inherit the same fragility — a route or an extractor is only as good as the last time someone checked it.

Repo: [github.com/DIYgod/RSSHub](https://github.com/DIYgod/RSSHub) — over 40k stars, AGPL-3.0