mirror of
https://github.com/YunoHost-Apps/rss-bridge_ynh.git
synced 2024-09-03 20:25:51 +02:00
112 lines
4.7 KiB
Markdown
112 lines
4.7 KiB
Markdown
# RSS-Bridge for YunoHost
|
|
|
|
[](https://dash.yunohost.org/appci/app/rss-bridge)  
|
|
[](https://install-app.yunohost.org/?app=rss-bridge)
|
|
|
|
> *This package allow you to install RSS-Bridge quickly and simply on a YunoHost server.
|
|
If you don't have YunoHost, please see [here](https://yunohost.org/#/install) to know how to install and enjoy it.*
|
|
|
|
## Overview
|
|
[RSS-Bridge](https://github.com/RSS-Bridge/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](http://www.flickr.com/explore) 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](http://cryptome.org/)
|
|
* `DansTonChat`: Most recent quotes from [danstonchat.com](http://danstonchat.com/)
|
|
* `DuckDuckGo`: Most recent results from [DuckDuckGo.com](https://duckduckgo.com/)
|
|
* `Instagram`: Most recent photos from an Instagram user
|
|
* `OpenClassrooms`: Lastest tutorials from [fr.openclassrooms.com](http://fr.openclassrooms.com/)
|
|
* `Pinterest`: Most recent photos from user or search
|
|
* `ScmbBridge`: Newest stories from [secouchermoinsbete.fr](http://secouchermoinsbete.fr/)
|
|
* `Wikipedia`: highlighted articles from [Wikipedia](https://wikipedia.org/) in English, German, French or Esperanto
|
|
* `Bandcamp` : Returns last release from [bandcamp](https://bandcamp.com/) for a tag
|
|
* `ThePirateBay` : Returns the newest indexed torrents from [The Pirate Bay](https://thepiratebay.se/) with keywords
|
|
* `Facebook` : Returns the latest posts on a page or profile on [Facebook](https://facebook.com/)
|
|
|
|
Plus [many other bridges](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](https://wtf.roflcopter.fr/rss-bridge/)
|
|
|
|
## 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 - [](https://ci-apps.yunohost.org/ci/apps/rss-bridge/)
|
|
* ARMv8-A - [](https://ci-apps-arm.yunohost.org/ci/apps/rss-bridge/)
|
|
|
|
## Limitations
|
|
|
|
* Any known limitations.
|
|
|
|
## Additional information
|
|
|
|
* Other information you would add about this application
|
|
|
|
## Links
|
|
|
|
* Report a bug: https://github.com/YunoHost-Apps/rss-bridge_ynh/issues
|
|
* App website: https://github.com/RSS-Bridge/rss-bridge
|
|
* Upstream app repository: https://github.com/RSS-Bridge/rss-bridge
|
|
* YunoHost website: https://yunohost.org/
|
|
|
|
---
|
|
|
|
## Developers info
|
|
|
|
Please do your pull request to the [testing branch](https://github.com/YunoHost-Apps/rss-bridge_ynh/tree/testing).
|
|
|
|
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
|
|
```
|