rss-bridge_ynh/README.md

RSS-Bridge for YunoHost

Lire ce readme en français.

This package allows you to install RSS-Bridge quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

RSS and Atom feed generator for websites that don't have one.

Shipped version: 2021-04-25~ynh1

Demo: https://wtf.roflcopter.fr/rss-bridge/

Screenshots

Disclaimers / important information

Supported sites/pages (main)

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

Plus many other bridges to enable, thanks to the community

Output format

Output format can take several forms:

• Atom : ATOM Feed, for use in RSS/Feed readers
• Mrss : MRSS Feed, for use in RSS/Feed readers
• Json : Json, for consumption by other applications.
• Html : Simple html page.
• Plaintext : raw text (php object, as returned by print_r)

Configuration

Enabling/Disabling bridges

By default, the script creates whitelist.txt and adds the main bridges (see above). you can edit it:

• to enable extra bridges (one bridge per line)
• to disable main bridges (remove the line)
• to enable all bridges (just one wildcard * as file content)

As a matter of simplicity, this YunoHost package enables every bridge by default.

Multi-users support

This is application is public and there's no notion of user.

Documentation and resources

• Official app website: https://github.com/RSS-Bridge/rss-bridge
• Official admin documentation: https://github.com/RSS-Bridge/rss-bridge/wiki
• Upstream app code repository: https://github.com/RSS-Bridge/rss-bridge
• YunoHost documentation for this app: https://yunohost.org/app_rss-bridge
• Report a bug: https://github.com/YunoHost-Apps/rss-bridge_ynh/issues

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install https://github.com/YunoHost-Apps/rss-bridge_ynh/tree/testing --debug
or
sudo yunohost app upgrade rss-bridge -u https://github.com/YunoHost-Apps/rss-bridge_ynh/tree/testing --debug

More info regarding app packaging: https://yunohost.org/packaging_apps