RSSHub README

The project's README from github.com/DIYgod/RSSHub. As one markdown file: README.md.

RSSHub

RSSHub

🧡 Everything is RSSible

docker publish npm publish test Test coverage Visitors

Telegram group Telegram channel X (Twitter)

Folo
RSSHub pairs especially well with Folo, an AI RSS reader for feed discovery and modern reading workflows. The project is also open source on GitHub.

Introduction

RSSHub is the world's largest RSS network, consisting of over 5,000 global instances.

RSSHub delivers millions of contents aggregated from all kinds of sources, our vibrant open source community is ensuring the deliver of RSSHub's new routes, new features and bug fixes.

Documentation | Folo | Telegram Group | Telegram Channel | X (Twitter)

Contribute

We welcome all pull requests. Suggestions and feedback are also welcomed here.

Refer to Quick Start

Deployment

Refer to Deployment

Special Thanks

Logo designer sheldonrrr

              

Author

RSSHub © DIYgod, Released under the AGPL-3.0 License.
Authored and maintained by DIYgod with help from contributors (list).

Blog @DIYgod · GitHub @DIYgod · X (Twitter) @DIYgod · Telegram Channel @awesomeDIYgod

RSSHub (DIYgod/RSSHub)

weibo
Searching Database…

46.6K ·GitHub
What is this?RSSHub is an open-source RSS feed generator that turns content from thousands of sites and apps (Bilibili, Twitter/X, Instagram, YouTube, Telegram, Spotify, and more) into RSS feeds you can subscribe to in any reader.
Is this a reader app, or something I run myself to produce feeds?It is a server application you deploy, not a reader itself; it exposes routes that output RSS/Atom/JSON feeds for a given site, which you then subscribe to in a separate reader app like Folo.
How do I get it running?You deploy RSSHub yourself, typically with the included Docker setup (docker-compose), or run it directly with Node.js; the project's Deployment docs walk through both options.
Do I need a specific Node.js version if I run it without Docker?Yes, running from source requires Node.js ^22.22.2 or ^24.15.0; using the Docker image avoids needing Node installed locally at all.
Can I just use a public RSSHub instance instead of hosting my own?Yes, there are thousands of community-run public instances you can use, though for reliability and to avoid rate limits many users choose to self-host.
What is Folo?Folo is an AI-powered RSS reader built to pair especially well with RSSHub, consuming the feeds RSSHub generates.
What is RSSHub Radar?RSSHub Radar is a browser extension that detects feeds (and matching RSSHub routes) on the website you're currently viewing so you can quickly subscribe.
How many sites or services does RSSHub cover?RSSHub ships thousands of routes covering sources like Bilibili, Douban, Dribbble, Instagram, Pixiv, Spotify, Telegram, TikTok, Twitter/X, WeChat, Weibo, Ximalaya, YouTube, and Zhihu, among many others.
Are there mobile companion tools?Yes, RSSBud and RSSAid are RSSHub Radar equivalents built specifically for iOS and Android respectively.
Creator
DIYgod
Size
1.2 GB
Stars
46.6K
Age
8y
Commits · 90 Days