mirror of https://github.com/YunoHost-Apps/rss-bridge_ynh.git synced 2024-09-03 20:25:51 +02:00

RSS-Bridge package for YunoHost

closember rss-bridge yunohost yunohost-apps

Find a file

Yunohost-Bot b240fe493a [autopatch] Update issue and PR templates		2021-05-13 17:52:12 +02:00
.github	[autopatch] Update issue and PR templates	2021-05-13 17:52:12 +02:00
conf	Upgrade to upstream version 2021-04-25	2021-04-30 15:10:53 +02:00
scripts	Small fix	2021-04-05 19:25:42 +02:00
check_process	Add new permissions	2021-02-26 08:57:55 +01:00
LICENSE	Initial commit for v0.2	2017-04-26 19:06:38 +02:00
manifest.json	Upgrade to upstream version 2021-04-25	2021-04-30 15:10:53 +02:00
README.md	Upgrade to upstream version 2021-04-25	2021-04-30 15:10:53 +02:00

README.md

RSS-Bridge for YunoHost

This package allow you to install RSS-Bridge quickly and simply on a YunoHost server.
If you don't have YunoHost, please see here to know how to install and enjoy it.

Overview

RSS-Bridge is a PHP project capable of generating ATOM feeds for websites which don't have one.

Shipped version: 2021-04-25

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)

Screenshots

RSS-Bridge hashtag (#rss-bridge) search on Twitter, in ATOM format (as displayed by Firefox):

Demo

Official demo

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.

Documentation

Official documentation: https://github.com/RSS-Bridge/rss-bridge/wiki
YunoHost documentation: If specific documentation is needed, feel free to contribute.

YunoHost specific features

Multi-users support

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

Supported architectures

x86-64 -
ARMv8-A -

Limitations

Any known limitations.

Additional information

Other information you would add about this application

Developers info

Please do 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