grubertech/rss-bridge repository overview

RSS-Bridge is a PHP project capable of generating RSS and Atom feeds for websites that don't have one. It can be used on webservers or as a stand-alone application in CLI mode.

Important: RSS-Bridge is not a feed reader or feed aggregator, but a tool to generate feeds that are consumed by feed readers and feed aggregators. Find a list of feed aggregators on Wikipedia⁠.

⁠Supported sites/pages (examples)

• Bandcamp : Returns last release from bandcamp⁠ for a tag
• Cryptome : Returns the most recent documents from Cryptome.org⁠
• DansTonChat: Most recent quotes from danstonchat.com⁠
• DuckDuckGo: Most recent results from DuckDuckGo.com⁠
• Facebook : Returns the latest posts on a page or profile on Facebook⁠ (There is an issue⁠ for public instances)
• FlickrExplore : Latest interesting images⁠ from Flickr
• GoogleSearch : Most recent results from Google Search
• Identi.ca : Identica user timeline (Should be compatible with other Pump.io instances)
• Instagram: Most recent photos from an Instagram user (It is recommended to configure⁠ this bridge to work)
• OpenClassrooms: Lastest tutorials from openclassrooms.com⁠
• Pinterest: Most recent photos from user or search
• ScmbBridge: Newest stories from secouchermoinsbete.fr⁠
• ThePirateBay : Returns the newest indexed torrents from The Pirate Bay⁠ with keywords
• Twitter : Return keyword/hashtag search or user timeline
• Wikipedia: highlighted articles from Wikipedia⁠ in English, German, French or Esperanto
• YouTube : YouTube user channel, playlist or search

And many more⁠, thanks to the community!

⁠Output format

RSS-Bridge is capable of producing several output formats:

• Atom : Atom feed, for use in feed readers
• Html : Simple HTML page
• Json : JSON, for consumption by other applications
• Mrss : MRSS feed, for use in feed readers
• Plaintext : Raw text, for consumption by other applications

You can extend RSS-Bridge with your own format, using the Format API⁠!

⁠Requirements

RSS-Bridge requires PHP 7.4 or higher with following extensions enabled:

• openssl⁠
• libxml⁠
• mbstring⁠
• simplexml⁠
• curl⁠
• json⁠
• filter⁠
• zip⁠ (for some bridges)
• sqlite3⁠ (only when using SQLiteCache)

Find more information on our Documentation⁠

⁠Enable / Disable bridges

RSS-Bridge allows you to take full control over which bridges are displayed to the user. That way you can host your own RSS-Bridge service with your favorite collection of bridges!

Find more information on the Documentation⁠

Notice: By default, RSS-Bridge will only show a small subset of bridges. Make sure to read up on whitelisting⁠ to unlock the full potential of RSS-Bridge!

⁠Getting involved

There are many ways for you to getting involved with RSS-Bridge. Here are a few things:

• Share RSS-Bridge with your friends (Twitter, Facebook, ...you name it...)
• Report broken bridges or bugs by opening Issues⁠ on GitHub
• Request new features or suggest ideas (via Issues⁠)
• Discuss bugs, features, ideas or issues⁠
• Add new bridges or improve the API
• Improve the Documentation⁠
• Host an instance of RSS-Bridge for your personal use or make it available to the community :sparkling_heart:

⁠Authors

We are RSS-Bridge community, a group of developers continuing the project initiated by sebsauvage, webmaster of sebsauvage.net⁠, author of Shaarli⁠ and ZeroBin⁠.

See CONTRIBUTORS.md⁠

⁠Licenses

The source code for RSS-Bridge is Public Domain⁠.

RSS-Bridge uses third party libraries with their own license:

• Parsedown⁠ licensed under the MIT License⁠
• PHP Simple HTML DOM Parser⁠ licensed under the MIT License⁠
• php-urljoin⁠ licensed under the MIT License⁠
• Laravel framework⁠ licensed under the MIT License⁠