Skip to content

micronode/feedhabit

Repository files navigation

feedhabit

A 'social' feed aggregator

http://feedhabit.com

Feed aggregation is difficult because of the sheer quantity of feed items. Applying similar principles as Twitter can help to overcome the information overload and find relevance in the data.

Why Twitter?

  1. The majority of tweets appear to be links to articles. So a Twitter-like application that sources items only from feeds seems valid
  2. Twitter allows you to 'follow' anyone, without need for approval/reciprocal follow
  3. Sharing feeds doesn't have as many privacy concerns as sharing private data

Why not FriendFeed?

  1. FriendFeed allows comments (status updates) without any basis (no point cloning Twitter)
  2. FriendFeed allows streams to be private (not open)
  3. FriendFeed allows posting images/files (copyright issues)

Feed Streams

The underlying concept of the Feed Stream is visible in two ways:

  1. The feeds you follow directly appear in your Feed Stream
  2. The Feed Streams you are following from other users also appear in your Feed Stream

Sharing

Sharing items in your public Feed Stream is achieved in the following ways:

  1. Flag - mark an article as worthy of inclusion in your public Feed Stream
  2. Tag - categorise an article with a templated string (like a hashtag)
  3. Annotate - add a comment to an item

Following

Following the Feed Stream of other users has the following effects to your Feed Stream:

  1. Items that have been Flagged, Tagged or Annotated by a user you are following will appear in your Feed Stream (even if you are not subscribed to the source feed)
  2. Items will aggregate and show any Flags, Tags and Annotations on items from those you are following

Feedhabit API

You can try the API using Docker as follows:

docker pull micronode/feedhabit # retrieve the latest feedhabit docker image

docker run -d -p 8080:8080 micronode/feedhabit # start the docker container

Open the following URL to explore the API using Swagger: http://localhost:8080/ui/index.html