Last update: 8/17/2012; 11:17:32 AM.

River2 Quick Start

What is River2? permalink

River2 is a River of News feed reader with lots of features.

Examples of rivers: 1, 2, 3.

Announcement of version 1.0.

Basic setup permalink

1. Install the OPML Editor if you need to.

2. Choose Tool Catalog from the Misc menu.

3. Click on the Install link in the same row as River2.

4. Click OK to all confirmation prompts.

5. Wait a couple of minutes.

6. Enter this URL: http://127.0.0.1:5337/rivers/admin/.

You should see your river, subscribed to a few default feeds. It'll update every 10 minutes.

Setting up a server on Amazon permalink

In step 1 above, you can quickly install a River2 server in Amazon's EC2 cloud by following the EC2 for Poets tutorial. If all goes well it takes about 15 minutes to 1/2 hour.

If you're new to Amazon's web services, the server is free for a year. Hard to beat that deal. And it's not too expensive after that.

Manage your river permalink

To subscribe and unsubscribe and monitor your river: http://127.0.0.1:5337/river2/.

The Feeds command, in the menu at the top of the page, shows you what feeds you're subscribed to and lets you add feeds or reading lists.

Sharing your river permalink

You can make your river public, by using the S3 path preference in River2's prefs system.

Once you've set that up, look for the URL to your public river on the Log page in River2.

We have a tutorial for setting up an S3 bucket called S3 for Poets.

Notes permalink

It's a stretch for most people to run a server in Amazon's cloud, but if you're an experienced computer user, you should be able to do it, especially with some trial and error and patience. Once you have it running, it can be very rewarding.

On the other hand, River2 is the one server-based app that you can actually run on a computer in your den or family room.

You can operate rivers for others. Every user gets a river. To create a new user, choose OPML Server from the dropdown menu at the right edge of the screen, and then click on New User from the menu. Enter a username and password.

Join the support list permalink

If you love River2 and want to get it working great, and help us continue testing and development, please join the Frontier-user mail list.

Questions here are much less likely to be answered.

blog comments powered by Disqus

Last udpate: 8/17/2012; 11:17:32 AM.