Displays a river of feeds in a simliar fashion to a news wire. Feed, River, Wire.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Feed River Wire

Feed River Wire is an experiment in news flow. As packaged, a river is created with streams of news from The Guardian UK, The New York Times, and Hacker News.

The river updates every 3 seconds to show you new articles that scripts pull down from various locations in the background.

Releasing this code into the wild could make it easier on somebody to create their own personal news river, with custom streams. So, go for it!


Configuration / Installation

DIY for sure, but shouldn't be too hard.

  • You'll need to make a config.php file based on config.sample.php in includes. This contains the MySQL DB config, API keys, and other general settings.
  • A database needs to be created in MySQL, and the tables in riverwire.sql should be added.
  • Cron should be setup to run catch_guardian_items.php, catch_hn_items.php, and catch_nyt_items.php on a regular basis.
    • The regular basis should match up with your script_max_run_time setting in config.php.
    • This could technically be infinite (I think), but I run the cron once an hour and set the script to run for 57 minutes. Probably because I'm weird.
  • You may need to change the river_source_ids setting in config.php to match your DB inserts, but I'm working on smoothing that out now.
  • That's it. River is flowing.

Live Example

A live example of Feed River Wire can be found at http://feedriverwire.com/, always running on the master branch.


Jeremy Felt


Copyright 2011 Jeremy Felt

Licensed under the MIT License - check the license.txt file.