Synchronizing with other feed readers

Awasu is able to synchronize with other feed readers but the plugins to do this must be installed manually.

  • Create a sub-directory called ESync in the Awasu installation directory e.g. C:\Program Files\Awasu\ESync

  • Unpack one or more of the following ZIP files into this new directory.
  • Restart Awasu.
You must read the notes below for each service for information about what features are available.

 

Synchronizing with Google Reader

Google Reader is Google's online feed reader. They only provide a limited API which prevents Awasu from synchronizing completely.

  • Awasu can keep which feed subscriptions you have in Awasu and Google Reader in sync.
    Since Google Reader does not support folders, feeds will instead be tagged with a special label. You can control which of your Google Reader feeds will be sync'ed with Awasu through the use of this label.

  • Awasu can update its record of which feed items have been read from Google Reader.
    The number of feed items parameter controls how many read items will be retrieved from Google Reader (and has to cover all channels being synchronized). This number should be increased as you synchronize more channels or as the amount of time between synchronizations increases. If it is too small, you may find that Awasu does not notice that certain feed items have already been read in Google Reader.

  • Awasu cannot update Google Reader's record of which feed items have been read in Awasu.

  • The way that Google Reader exposes which items has been read has been designed for people implementing a feed reader, not a synchronization feature, and is very inefficient. If you are going to be synchronizing which feed items have been read, it is recommended that you don't keep too many feeds synchronized. Start with a handful and work your way up. It will be very slow if you are on dial-up!

Details of Google Reader's API have not been officially released and were obtained by reverse-engineering their web site. It is subject to change at any time, which could break Awasu. If you find things stop working, please let us know and we'll make the necessary changes to get things going again.

 

Synchronizing with Bloglines

Bloglines is a popular online feed reader. They only provide a very limited API which prevents Awasu from synchronizing completely.

  • Your Bloglines feed subscriptions can be transferred into Awasu, but not out.

  • Which feed items have been read in Bloglines can be transferred into Awasu, but not out.

  • The way that Bloglines exposes which items has been read has been designed for people implementing a feed reader, not a synchronization feature, and is very inefficient. If you are going to be synchronizing which feed items have been read, it is recommended that you don't keep too many feeds synchronized. Start with a handful and work your way up. It will be very slow if you are on dial-up!

 

Synchronizing with Gregarius

Gregarius is an open-source online feed reader that has been modified to allow Awasu to provide a fully-featured synchronization service.

You must be able to run a copy of Gregarius 0.5.4 on your own web server. It requires PHP and MySQL or SQLite. Installation is very simple and only takes a few minutes.

Once you have Gregarius up and running, create a sub-directory under the main installation directory called siam and unpack this ZIP file into it.

All you have to do now is configure Awasu with the base URL of your Gregarius installation, the account name and password.