You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Christian Schabesberger 372eccd7b2
[Nordbayern] Update regions (#2966)
19 hours ago
.github [core] prtester fix for optgroups (#2896) 1 month ago
actions refactor: general code base refactor (#2950) 1 week ago
bridges [Nordbayern] Update regions (#2966) 19 hours ago
cache [TwitterBridge] Fix the bridge using a brand new API 2 years ago
caches refactor: general code base refactor (#2950) 1 week ago
config docker: Switch to nginx in docker image (#2721) 3 months ago
contrib fix: use default headers in getContents() (#2927) 2 weeks ago
docs refactor: general code base refactor (#2950) 1 week ago
formats refactor: general code base refactor (#2950) 1 week ago
lib feat: use bridge description and short name in search (#2952) 1 week ago
static docs: revamp README (#2954) 1 week ago
templates refactor: general code base refactor (#2950) 1 week ago
tests refactor: general code base refactor (#2950) 1 week ago
vendor Add php-urljoin license 2 months ago
.dockerignore [Docker file] Fix wrong version string in docker images (#2497) 5 months ago
.git-blame-ignore-revs Add .git-blame-ignore-revs file (#2903) 1 month ago
.gitattributes [Docker] force unix line ending on bash files to prevent docker run failing on windows (#2629) 4 months ago
.gitignore docker: Switch to nginx in docker image (#2721) 3 months ago
CONTRIBUTORS.md chore: introduce CONTRIBUTORS.md (#2839) 1 month ago
Dockerfile [Core] Add expose to dockerfile (#2762) 3 months ago
README.md docs: revamp README (#2954) 1 week ago
UNLICENSE let's unlicense ! 8 years ago
app.json Update app.json 4 months ago
composer.json refactor: general code base refactor (#2950) 1 week ago
composer.lock composer: Update lockfile 1 month ago
config.default.ini.php refactor: general code base refactor (#2950) 1 week ago
docker-bake.hcl New docker build mechanism (#2268) 10 months ago
docker-entrypoint.sh docker: fix find error (#2733) 3 months ago
index.php refactor: general code base refactor (#2950) 1 week ago
phpcompatibility.xml refactor: general code base refactor (#2950) 1 week ago
phpcs.xml refactor: general code base refactor (#2950) 1 week ago
phpunit.xml refactor: ./tests (#2649) 4 months ago
scalingo.json Typo 6 years ago
whitelist.default.txt core: Move default bridges to whitelist.default.txt 3 years ago

README.md

RSS-Bridge

RSS-Bridge

RSS-Bridge is a PHP project capable of generating RSS and Atom feeds for websites that don't have one.

LICENSE GitHub release irc.libera.chat Chat on Matrix Actions Status

Screenshot of the Twitter bridge configuration:

Screenshot #1

Screenshot of the Twitter bridge for Rasmus Lerdorf:

Screenshot #2

Documentation

Check out RSS-Bridge right now on https://rss-bridge.org/bridge01 or find another public instance.

Tutorial

Install with git:

cd /var/www
git clone https://github.com/RSS-Bridge/rss-bridge.git

# Give the http user write permission to the cache folder
chown www-data:www-data /var/www/rss-bridge/cache

# Optionally copy over the default config file
cp config.default.ini.php config.ini.php

# Optionally copy over the default whitelist file
cp whitelist.default.txt whitelist.txt

Example config for nginx:

# /etc/nginx/sites-enabled/rssbridge
server {
    listen 80;
    # server_name example.com;
    root /var/www/rss-bridge;
    index index.php;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php-fpm.sock;
    }
}

Install with Docker:

Install by using docker image from Docker Hub:

# Create container
docker create --name=rss-bridge --publish 3000:80 rssbridge/rss-bridge

# Start container
docker start rss-bridge

Browse http://localhost:3000/

Install by locally building the image:

# Build image from Dockerfile
docker build -t rss-bridge .

# Create container
docker create --name rss-bridge --publish 3000:80 rss-bridge

# Start the container
docker start rss-bridge

Browse http://localhost:3000/

Alternative installation methods

Deploy on Scalingo Deploy to Heroku Deploy to Cloudron

The Heroku quick deploy currently does not work. It might possibly work if you fork this repo and modify the repository in scalingo.json. See https://github.com/RSS-Bridge/rss-bridge/issues/2688

Learn more in Installation.

Create a bridge

Create the new bridge in bridges/ExecuteBridge.php:

<?php

class ExecuteBridge extends BridgeAbstract
{
    const NAME = 'Execute Program Blog';

    public function collectData()
    {
        $url = 'https://www.executeprogram.com/api/pages/blog';
        $data = json_decode(getContents($url));

        foreach ($data->posts as $post) {
            $this->items[] = [
                'uri'       => sprintf('https://www.executeprogram.com/blog/%s', $post->slug),
                'title'     => $post->title,
                'content'   => $post->body,
            ];
        }
    }
}

Learn more in bridge api.

How-to

How to enable all bridges

Write an asterisks in whitelist.txt:

echo '*' > whitelist.txt

Learn more in enabling briges

How to enable a bridge

Add the bridge name to whitelist.txt:

echo 'FirefoxAddonsBridge' >> whitelist.txt

How to enable debug mode

Create a file named DEBUG:

touch DEBUG

Learn more in debug mode.

How to create a new output format

Create a new format.

Explanation

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

RSS-Bridge uses caching to prevent services from banning your server for repeatedly updating feeds. The specific cache duration can be different between bridges. Cached files are deleted automatically after 24 hours.

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!

Supported 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

Reference

A selection of bridges

  • 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!

Licenses

The source code for RSS-Bridge is Public Domain.

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

Rant

Dear so-called "social" websites.

Your catchword is "share", but you don't want us to share. You want to keep us within your walled gardens. That's why you've been removing RSS links from webpages, hiding them deep on your website, or removed feeds entirely, replacing it with crippled or demented proprietary API. FUCK YOU.

You're not social when you hamper sharing by removing feeds. You're happy to have customers creating content for your ecosystem, but you don't want this content out - a content you do not even own. Google Takeout is just a gimmick. We want our data to flow, we want RSS or Atom feeds.

We want to share with friends, using open protocols: RSS, Atom, XMPP, whatever. Because no one wants to have your service with your applications using your API force-feeding them. Friends must be free to choose whatever software and service they want.

We are rebuilding bridges you have willfully destroyed.

Get your shit together: Put RSS/Atom back in.