unsubbed.co

RSSHub

RSSHub generates RSS feeds from virtually any website or platform, turning social media, news sites, forums, and services without native RSS into subscribable feeds.

42,757 GitHub stars, 5,000+ global instances, and one mission: make everything RSSible.

TL;DR

  • What it is: An open-source RSS generator — not a reader. RSSHub creates RSS feeds for websites, social platforms, and services that don’t provide them natively. Think of it as a feed factory, not a feed consumer [README][5].
  • Who it’s for: RSS power users, indie developers, and self-hosters who want to read content on their terms — without algorithmic feeds, surveillance capitalism, or the anxiety of checking 15 different apps [5].
  • Cost savings: Free public instance (rate-limited), or self-hosted on a $5–10/mo VPS with no limits. There’s no SaaS pricing page because there’s no SaaS product — just your server and a Docker container.
  • Key strength: Breadth. Over 900 pre-built routes cover 200+ services including YouTube, Twitter/X, Instagram, Telegram, Spotify, TikTok, Bilibili, GitHub, and hundreds more [README][5]. If a website exists, someone has probably written an RSSHub route for it.
  • Key weakness: Some routes break when platforms change their APIs or block scrapers. Twitter/X routes require API credentials that are increasingly hard to get. Setup is Docker-straightforward but the underlying architecture (Redis required, Puppeteer optional) has more moving parts than a single-binary tool [3][4].

What is RSSHub

RSSHub is a self-hosted service that generates RSS feeds from sources that don’t publish them natively. You install it on a server, point it at a URL pattern, and it returns a valid RSS/Atom feed you can subscribe to in any reader.

The tagline “Everything is RSSible” is close to accurate. The project maintains routes for YouTube channels, Twitter timelines, Instagram accounts, Reddit posts, GitHub releases, Telegram channels, Spotify new releases, job boards, government notices, and well over a thousand other sources [README][5]. Routes are contributed by the community — 1,300+ contributors as of this writing — which is why the catalog spans both global platforms and Chinese services like Bilibili and Weibo that Western aggregators typically ignore [README].

What makes RSSHub different from just subscribing to a website’s existing RSS feed is that it handles sites that have either dropped RSS support (most of the modern web) or never offered it (every major social platform). A French tech blogger writing about the project captured the frustration cleanly: “La plupart des sites web ont abandonné leur flux RSS sans oublier que Twitter, Instagram, YouTube, TikTok… aucun de ces services ne propose de flux natif” — most websites have abandoned RSS, and none of the major social platforms provide native feeds [5].

RSSHub solves that by running a scraper/route layer in the middle. You hit your RSSHub instance with a URL like /youtube/channel/UC_x5XG1OV2P6uZZ5FSM9Ttw, and RSSHub fetches the source, parses the content, and returns a standard RSS feed.

The project sits at 42,757 GitHub stars and runs as a distributed network of over 5,000 global instances — meaning you can use the public demo instance at rsshub.app for free, or run your own for privacy and rate-limit control [README].


Why People Choose It

The short answer: algorithmic fatigue. The longer answer involves control, privacy, and the practical death of RSS on the modern web.

The korben.info review [5] frames it the most directly: RSS was the revolution of the early 2000s web — a way to follow sources without letting platforms decide what you see, in what order, or with what commercial intent. Then the platforms killed it, one by one. RSSHub is the underground railroad for people who refuse to accept that arrangement.

A blogger at timowens.io [3] ran through a practical install test and arrived at an honest assessment: RSSHub is “in some ways a programmmatic screen scraper to RSS feed generation tool” where “anyone can write a ‘route’ that then allows you with certain URLs to pull in an RSS feed even if the site doesn’t offer one.” That’s accurate and useful framing. It’s not magic — it’s a structured scraper with a shared community library of scrapers.

Where it shines is convenience. The public instance requires zero setup, and the browser extension (RSSHub Radar, available for Chrome, Firefox, Edge, and Safari) auto-detects available routes when you visit any website [5]. Visit a YouTube channel and RSSHub Radar tells you the exact URL to subscribe to in your reader. That discovery layer turns a technically interesting project into something a non-developer can use.

Where it shows limits: the blog.timowens.io author tried to set up a Twitter route and bailed — “accessing Twitter programatically appears to be as much a dumpster fire as the website itself is” [3]. The Google News route returned errors. The Verge route worked cleanly. That variance is characteristic of any web scraper that depends on third-party site structure and API access — some routes are maintained, some are stale, and platform hostility toward scraping is a constant headwind.

The companion app Folo (an AI RSS reader built by the same developer, DIYgod, also open source) is increasingly positioned as the intended frontend for RSSHub — shared instances, AI-powered discovery, and modern reading workflows [README]. The two together form a complete self-hosted RSS stack.


Features

Core capability:

  • Generates RSS/Atom feeds from sources that don’t publish them [README]
  • 900+ pre-built routes covering 200+ services: YouTube, Twitter/X, Instagram, Telegram, Reddit, GitHub, Spotify, Bilibili, TikTok, Weibo, and hundreds more [README][5]
  • Public instance (rsshub.app) for immediate use without any setup [5]
  • Full-text feed support for sources that normally publish truncated excerpts (tested working for The Verge) [3]

Ecosystem:

  • RSSHub Radar — browser extension (Chrome/Firefox/Edge/Safari) that auto-detects RSS routes on any page you visit [5]
  • RSSBud — iOS version of Radar, optimized for the mobile ecosystem [README]
  • RSSAid — Android equivalent, built with Flutter [README]
  • Folo — an AI RSS reader that integrates tightly with RSSHub for shared instances and modern reading [README]

Self-host infrastructure:

  • Docker Compose deployment with Redis for caching [3][4]
  • Optional Puppeteer/browserless integration for JavaScript-heavy sites that require a headless browser to scrape [4]
  • Configurable rate limiting, cache duration, and access control [README]
  • 5,000+ community-run public instances as fallback/mirror network [README]

Route system:

  • Routes are Node.js modules contributed by the community [README]
  • Route configuration via URL parameters (language, region, content type) [3]
  • Some routes require API tokens as environment variables — especially social platforms [3]

Pricing: SaaS vs Self-Hosted Math

There’s no SaaS version of RSSHub with a pricing tier. The project itself is free in both deployment modes.

Public instance (rsshub.app):

  • Free, no account required
  • Rate-limited — the project handles millions of requests per month distributed across 5,000+ instances, so the public endpoint is throttled to prevent abuse [README]
  • Fine for occasional use and testing; not reliable for hundreds of subscriptions or high-frequency polling

Self-hosted:

  • Software: $0 (AGPL-3.0) [README]
  • VPS: $5–10/mo on Hetzner, Contabo, or Fly.io
  • No per-request, per-feed, or per-user costs

The realistic comparison for cost isn’t against a direct RSSHub competitor — it’s against the subscription services people use instead of RSS because the open web fragmented. Feedly Pro ($8/mo) and Inoreader Pro ($9.99/mo) both offer some feed discovery and monitoring features. Neither generates feeds from sources that don’t publish RSS natively; both are closed-source SaaS with their own content filtering.

For a founder monitoring 50 competitor blogs, Twitter accounts, and job boards through a proper RSS setup (RSSHub + Folo or any reader), the math is: $0 software + $6/mo VPS = $6/mo, forever. No tier upgrades as you add more feeds. No per-seat pricing if you share the instance with a small team.


Deployment Reality Check

The Docker Compose deployment is documented and functional [3][4]. The timowens.io author got it running in a single session with one stumble (needed to map port 80 instead of 443 to work with an SSL-terminating load balancer) [3].

The official docker-compose.yml pulls three services: rsshub, Redis, and browserless (Puppeteer-based headless Chrome for JS-heavy routes) [4]. Redis is mandatory for caching; browserless is optional but needed for any route that requires JavaScript rendering.

What you need:

  • A Linux VPS with at least 1GB RAM (2GB recommended if running browserless)
  • Docker and docker-compose
  • A reverse proxy (Caddy or nginx) for HTTPS
  • Optional: a domain name

The install path:

wget https://raw.githubusercontent.com/DIYgod/RSSHub/master/docker-compose.yml
docker volume create redis-data
docker-compose up -d

That’s the documented quick-start [3]. It works. The service binds to port 1200 internally; map that to 80 (not 443) if you’re behind a load balancer that handles TLS [3].

What can go sideways:

  • Some routes silently fail or return errors if the underlying site has changed its structure. The Google News route returned errors in a live test in 2025 [3].
  • Routes for major social platforms (Twitter/X especially) require API credentials configured as environment variables. Getting those credentials is its own journey, and platform policy changes can revoke access [3].
  • The public instance is rate-limited enough to be unreliable for production use. Self-hosting is the only reliable path [5].
  • Fly.io no longer offers a free hobby plan as of 2024 — a Chinese deployment guide [2] that recommended it as a free hosting option is now outdated. Current pricing is $5/mo for the smallest plan [2].
  • AGPL-3.0 license is more restrictive than MIT. If you’re embedding RSSHub in a commercial product, you’re obligated to open-source your modifications [README]. Not an issue for personal use; worth checking if you’re building on top of it.

Realistic time estimate for someone comfortable with Docker: 20–45 minutes to a working instance. For someone new to Linux servers following a guide: 2–3 hours including domain and HTTPS setup.


Pros and Cons

Pros

  • Unmatched route catalog. 900+ routes covering 200+ services — YouTube, Instagram, Twitter/X, Telegram, Spotify, TikTok, Reddit, GitHub, and dozens of Chinese platforms that Western tools don’t touch [README][5]. The breadth is a genuine differentiator.
  • Truly free. No freemium tier gating useful routes. No API key required for the public instance for most routes. Self-hosted costs only VPS time [README].
  • Discovery tooling included. RSSHub Radar makes route discovery passive — it shows you available feeds as you browse, no manual URL construction needed [5].
  • 5,000+ public instances. If the main instance is slow, there are thousands of mirrors. If your self-hosted instance is down, you have fallback options [README].
  • Active community. 1,300+ contributors, frequent route additions, Telegram group and channel for support [README].
  • Pairs well with Folo. The same developer’s AI reader creates a cohesive self-hosted reading stack [README].

Cons

  • Route fragility. Routes depend on third-party site structure. When platforms update their frontend, routes break. Twitter/X access is particularly unreliable given ongoing API restrictions [3].
  • AGPL-3.0, not MIT. If you’re building commercial products on top of it, you need to read the license carefully. The “open” positioning on the website glosses over this [README].
  • Redis and Puppeteer dependencies. Not a single binary. You’re running 2–3 containers, and the browserless container (Puppeteer/Chrome) is resource-heavy [4].
  • No authentication by default. Your RSSHub instance is public to anyone who knows the URL unless you configure access control. The docs cover this, but the default Docker Compose doesn’t lock it down [README].
  • Uneven route quality. Community-contributed routes vary in maintenance quality. Some work flawlessly; some are stale. There’s no quality tier or freshness indicator [3].
  • API token management is manual. Routes for authenticated services require you to add credentials as environment variables in the Docker config — not a UI flow [3].

Who Should Use This / Who Shouldn’t

Use RSSHub if:

  • You use RSS seriously and want feeds from sources that don’t publish them natively (social media, YouTube, forums, job boards).
  • You’re comfortable with Docker and can maintain a small self-hosted service.
  • You want to read content without algorithmic interference and track dozens of sources in one place.
  • You’re building a feed monitoring setup for competitive research or content aggregation.
  • You want the RSSHub Radar browser extension to auto-surface feeds as you browse — even if you only use the public instance.

Skip it (use the public instance instead) if:

  • You only need a handful of feeds and don’t want to manage infrastructure — rsshub.app covers casual use for free, rate limits permitting.

Skip it entirely if:

  • You need guaranteed uptime for production monitoring — route breakage is unpredictable, and this isn’t a service with SLA commitments.
  • You need Twitter/X feeds reliably — platform API hostility makes this category of routes the least stable.
  • You want a managed, maintained feed service with customer support — RSSHub is community-maintained OSS, not a SaaS product.
  • Your use case is embedding feed generation in a commercial product — check the AGPL-3.0 license obligations first.

Alternatives Worth Considering

  • Miniflux — a minimal, self-hosted RSS reader (not a feed generator like RSSHub). Pairs well with RSSHub: Miniflux reads the feeds RSSHub generates.
  • FreshRSS — another self-hosted RSS reader. The deployment guide at linzichun.com [2] explicitly runs FreshRSS + RSSHub together as a combined stack.
  • Folo — the same developer’s AI RSS reader, now separate from RSSHub but designed to work with it. Open source, actively developed [README].
  • Inoreader — commercial RSS reader with some feed-generation capabilities for sources without native RSS. $9.99/mo. Closed source, no self-hosting.
  • Feedly — similar commercial RSS reader, $8/mo for Pro. More polish, less control.
  • Kill the Newsletter — narrowly converts email newsletters to RSS feeds. More limited scope than RSSHub but useful if newsletters are your primary use case.
  • RSS-Bridge — a PHP-based alternative to RSSHub with similar goals (generating feeds for sites that don’t have them). Smaller route catalog, less active development.

For someone building a complete self-hosted reading setup, the practical answer is: RSSHub for feed generation + Folo or FreshRSS for reading. That combination covers what Feedly/Inoreader charge monthly for.


Bottom Line

RSSHub is the most credible answer to a specific and recurring problem: the modern web has largely abandoned RSS, and the platforms where attention lives (YouTube, Twitter/X, Instagram) have never supported it. The project maintains 900+ routes for scraping those sources into standard feeds, runs as a worldwide network of 5,000+ instances, and costs nothing to self-host. The trade-off is exactly what you’d expect from a community scraper: route quality varies, platform changes break things, and some services (Twitter/X specifically) are increasingly hostile to programmatic access. If you’re an RSS user frustrated by how much of the web has gone dark for feed readers, RSSHub is the tool. If you need guaranteed uptime and SLA-backed reliability, it isn’t. For a non-technical founder who wants to escape algorithmic feeds and monitor dozens of sources without paying Feedly $8 a month, a $6 VPS running RSSHub and FreshRSS is the obvious move — if someone sets it up for them once.

If that setup is the blocker, that’s exactly what upready.dev deploys for clients. One-time fee, you own the infrastructure.


Sources

  1. Tim Owens, blog.timowens.io“Weekly App Install: RSSHub”. https://blog.timowens.io/weekly-app-install-rsshub/
  2. Linzichun.com“使用Fly.io Docker快速免费部署FreshRSS和RSSHub服务” (Deploy FreshRSS and RSSHub free on Fly.io). https://linzichun.com/posts/deploy-freshrss-rsshub-on-flyio-docker-for-free/
  3. e-whisper.com“K8S Utility No. 5 - kompose” (includes RSSHub docker-compose.yml as reference example). https://e-whisper.com/posts/35291/
  4. Korben, korben.info“RSSHub - L’outil qui transforme n’importe quel site en flux RSS”. https://korben.info/rsshub-rss-flux-sites-aaron-swartz.html

Primary sources:

Features

Integrations & APIs

  • Plugin / Extension System

Mobile & Desktop

  • Mobile App