{"id":15032402,"url":"https://github.com/cay-zhang/rssbud","last_synced_at":"2025-05-14T20:04:36.420Z","repository":{"id":37534651,"uuid":"277775443","full_name":"Cay-Zhang/RSSBud","owner":"Cay-Zhang","description":"An RSS feed discovery app for iOS/macOS that works particularly well with RSSHub, a popular feed generation service. Available on the App Store.","archived":false,"fork":false,"pushed_at":"2025-04-12T20:10:15.000Z","size":38411,"stargazers_count":1392,"open_issues_count":6,"forks_count":42,"subscribers_count":37,"default_branch":"main","last_synced_at":"2025-04-13T15:09:49.059Z","etag":null,"topics":["ios","rss","rss-generator","rssbud","rsshub","rsshub-radar","swiftui"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cay-Zhang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://github.com/Cay-Zhang/Cay-Zhang#support-me"]}},"created_at":"2020-07-07T09:35:31.000Z","updated_at":"2025-04-13T13:31:59.000Z","dependencies_parsed_at":"2024-01-27T00:21:47.998Z","dependency_job_id":"2637c4db-ff3d-411f-8970-3666c44f9c6f","html_url":"https://github.com/Cay-Zhang/RSSBud","commit_stats":{"total_commits":2022,"total_committers":2,"mean_commits":1011.0,"dds":"0.20276953511374873","last_synced_commit":"fdaaf164ed8b52fda22f3b9958ae4ad82744f919"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cay-Zhang%2FRSSBud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cay-Zhang%2FRSSBud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cay-Zhang%2FRSSBud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cay-Zhang%2FRSSBud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cay-Zhang","download_url":"https://codeload.github.com/Cay-Zhang/RSSBud/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248732486,"owners_count":21152852,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ios","rss","rss-generator","rssbud","rsshub","rsshub-radar","swiftui"],"created_at":"2024-09-24T20:18:18.165Z","updated_at":"2025-04-13T15:09:59.711Z","avatar_url":"https://github.com/Cay-Zhang.png","language":"JavaScript","funding_links":["https://github.com/Cay-Zhang/Cay-Zhang#support-me"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=center\u003e\n\u003cimg src=\"Readme Assets/Icon with Shadow.png\" width=\"140\" height=\"140\"\u003e\n\u003c/div\u003e\n\u003ch1 align=center\u003eRSSBud\u003c/h1\u003e\n\n\u003cp align=center\u003e\n\u003ca href=\"https://developer.apple.com/swift\"\u003e\u003cimg src=\"https://img.shields.io/badge/swift-5.8-fe562e?style=flat-square\"\u003e\u003c/a\u003e\n\u003ca href=\"https://developer.apple.com/ios\"\u003e\u003cimg src=\"https://img.shields.io/badge/iOS-15%2B-blue?style=flat-square\"\u003e\u003c/a\u003e\n\u003ca href=\"https://developer.apple.com/macos\"\u003e\u003cimg src=\"https://img.shields.io/badge/macOS%20(Apple%20Silicon)-12%2B-blue?style=flat-square\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Cay-Zhang/RSSBud/blob/master/LICENSE\"\u003e\u003cimg src=\"http://img.shields.io/badge/license-MIT-lightgrey.svg?style=flat-square\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n[中文文档](README.zh-CN.md)\n\n\u003e RSSBud can help you quickly discover and subscribe to RSS feeds from websites or apps, especially those provided by [RSSHub](https://github.com/DIYgod/RSSHub). It supports the parameters feature of RSSHub which facilitates extra functionalities such as filtering by feed content and full text fetching.\n\n[Telegram Group](https://t.me/RSSBud_Discussion)\n\nhttps://github.com/Cay-Zhang/RSSBud/assets/13341339/f68fde0b-1e81-4cda-99af-f1b0deeb68f7\n\n## Download\n\u003ca href=\"https://apps.apple.com/us/app/rssbud/id1531443645?itsct=apps_box_link\u0026itscg=30200\"\u003e\u003cimg src=\"https://tools.applemediaservices.com/api/badges/download-on-the-app-store/black/en-US?size=250x83\u0026amp;releaseDate=1605052800\u0026h=3dc9b44d4b825017f8746f19cec2b07f\" alt=\"Download on the App Store\" width=\"200\"\u003e\u003c/a\u003e\n\n\u003cimg src=\"https://tools-qr-production.s3.amazonaws.com/output/apple-toolbox/dace82ddc6942d582d27ad4d2ba31d58/c6e9f5d0-cee7-4523-ac64-ca89de19e8dc.png\" width=\"200\"\u003e\n\n## Features\n- [x] Detects RSS feeds in web pages\n- [x] Detects RSSHub feeds applicable for web pages (supports almost all rules of RSSHub Radar)\n- [x] Detects other RSS feeds applicable for web pages (powered by [RSSBud Rules](#rules))\n- [x] Optimized for mobile environment (automatically expands URLs and adapts to common mobile sub-domains)\n- [x] Share sheet extension\n- [x] Quick subscription to Reeder, Fiery Feeds, Ego Reader, and system default RSS reader\n- [x] Quick subscription to Tiny Tiny RSS, Miniflux, Fresh RSS, Feedly, Inoreader, Feedbin, The Old Reader, Feeds Pub\n- [x] Parameter editor for RSSHub feeds\n- [x] Rules kept up-to-date automatically\n- [x] Customizable remote rules files\n- [x] Simultaneously matches against multiple rules files\n- [x] RSSHub access control (automatically generates MD5 access code)\n- [x] Supports x-callback-url; can be used in \"Shortcuts\" app to facilitate a variety of powerful functions (see [Shortcut Workshop](#shortcut-workshop) and [Scheme](#x-callback-url-scheme))\n\n## Shortcut Workshop\nIf RSSBud doesn't support your RSS reader/service, or you want to integrate RSSBud into your workflow, you can write shortcuts utilizing RSSBud's support for x-callback-url to fulfill your needs. Let's start with the following ones!\n\n[RSSBud Starter Shortcut](https://www.icloud.com/shortcuts/0db563bf6ca24af296264ebb561e485a) by cayZ | A template for RSSBud related shortcuts that sets up the variables and supports share sheets.\n\n[Analyze with RSSBud and Send with Telegram](https://www.icloud.com/shortcuts/512b781474da4c868113aba21889ab56) by cayZ | Send RSSBud analysis results to Telegram with customizable message template and recipient.\n\n[Analyze with RSSBud and Subscribe with Pocket Casts](https://www.icloud.com/shortcuts/3cf4b0660bfb441c9dabd21e6de523bf) by cayZ | Send RSSBud analysis results to Pocket Casts (podcast RSS only).\n\n[Scan QR and Analyze with RSSBud](https://www.icloud.com/shortcuts/997677502579494881f66d661bb2f773) by cayZ | Get URL from scanned QR code and analyze with RSSBud.\n\n\u003e If you think you've got an idea of a shortcut that can benefit a larger audience, you're welcomed to submit an issue!\n\n## X-callback-url Scheme\nRSSBud has implemented the [x-callback-url](http://x-callback-url.com/) protocol, which provides a standardized means for iOS developers to expose and document the methods they make available to other apps via custom URL schemes.\n\nYou can open the following URL to let RSSBud analyze the provided URL and return the RSS feed chosen by the user:\n```\nrssbud://x-callback-url/analyze?url[\u0026x-callback-parameters...]\n```\n\n#### Parameters\n- **url** The URL you want RSSBud to analyze\n#### x-success\n- **feed_title** The name of the RSS feed chosen by the user\n- **feed_url** The URL of the RSS feed chosen by the user\n\n## PopClip Extension\nIf you happen use both RSSBud and [PopClip](https://pilotmoon.com/popclip/) on macOS, here's a handy  extension that can be used to analyze selected URLs with RSSBud. Simply select everything in the code block below and you will see an option to install the extension in PopClip.\n\n```yaml\n#popclip\nname: RSSBud\nicon: iconify:ph:rss-bold\nurl: rssbud:///analyze?url=***\n```\n\n## Notes for Building from Source\nThe core functionality of RSSBud comes from [RSSBud Core](https://github.com/Cay-Zhang/RSSBud/tree/main/Shared/Core), a sub-project written in JavaScript. The code is mainly referenced from [RSSHub Radar](https://github.com/DIYgod/RSSHub-Radar).\n\nMake sure you have [Node.js](https://nodejs.org/) installed before you build with Xcode.\n\nIf you wish to use the action extension, please set up your own App Group in both the iOS and Action Extension targets and modify `RSSBud.appGroupIdentifier` accordingly.\n\n## Rules\nRSSBud’s functionality is largely powered by **rules** from two open-source projects. Please consider contributing to the appropriate rules if a particular feed can’t be discovered by RSSBud.\n\n- [RSSHub Radar Rules](https://rsshub.js.org/build/radar-rules.js) are created and maintained by the **RSSHub** community. They are used to discover **RSSHub feeds**.\n\n    [Submit new RSSHub Radar rules](https://docs.rsshub.app/en/joinus/new-radar.html)\n\n- [RSSBud Rules](https://github.com/Cay-Zhang/RSSBudRules) are a superset of RSSHub Radar rules. The extended schema allows **non-RSSHub feeds** (e.g. official RSS feeds that are not discoverable by parsing HTML) to be discovered. Please consider contributing to RSSHub Radar rules first if the feed is an **RSSHub feed**.\n\n    [Submit new RSSBud rules](https://github.com/Cay-Zhang/RSSBudRules)\n\n## Similar projects\n- [RSSHub Radar by DIYgod (Browser extension)](https://github.com/DIYgod/RSSHub-Radar)\n- [RSSAid by Leetao (Flutter)](https://github.com/LeetaoGoooo/RSSAid)\n\n## Author\nRSSBud is made by cayZ and is open-source under the **[MIT License](https://choosealicense.com/licenses/mit/)**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcay-zhang%2Frssbud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcay-zhang%2Frssbud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcay-zhang%2Frssbud/lists"}