tweeper.1.asciidoc: document how to use the PHP built-in web server
[tweeper.git] / README
diff --git a/README b/README
index 925bb28..7703e64 100644 (file)
--- a/README
+++ b/README
@@ -1,10 +1,12 @@
-Tweeper is a web scraper which extracts the most recent public tweets of
-a given user from their home page on Twitter.com and formats them in RSS, so
-the information can be conveniently accessed and collected by a feed reader.
+Tweeper is a web scraper which can be used to conveniently follow the public
+activity of social network users without the need to log in or even be
+subscribed to the social network; tweeper converts the public information to
+RSS so that it can be accessed and collected by a feed reader.
 
-Since Jun 11th 2013 Twitter.com retired their API v1.0, so it's not possible
-to access a user timeline via RSS anymore, and it's also become mandatory to
-authenticate via OAuth to access this _public_ information in JSON format:
+Since Jun 11th 2013, when Twitter.com retired their API v1.0, it has not been
+possible anymore to access a user timeline via RSS, and it has also become
+mandatory to authenticate via OAuth to access this _public_ information in the
+JSON format:
 
   https://dev.twitter.com/discussions/16289
   https://dev.twitter.com/discussions/11564
@@ -24,6 +26,19 @@ whom you are friend to.
 
 [1] http://www.urbandictionary.com/define.php?term=TWEEPER&defid=3743173
 
+Tweeper can easily scrape sites other than Twitter, it is just a matter of
+writing an xsl stylesheet for the transformation; an example for pump.io
+activity stream is provided in rss_converter_pump.io.xsl
+
+The currently supported sites are:
+
+  * Twitter.com
+  * Pump.io based websites, like Identi.ca
+  * Dilbert.com
+  * Howtoons.com
+  * Instagram.com
+  * Facebook.com (public pages)
+
 Tweeper can be used via web or as a command line program, for example as
 a filter in your feed reader, by passing the URL of the user's public timeline
 as the first argument.
@@ -36,6 +51,10 @@ Example of use as a Liferea[2] filter:
 
   $ liferea-add-feed  "|php .../path_to_tweeper/tweeper.php http://twitter.com/NSAcareers"
 
+Example of use with identi.ca:
+
+  $ liferea-add-feed  "|php .../path_to_tweeper/tweeper.php http://identi.ca/evan"
+
 [2] http://lzone.de/liferea/
 
 Tweeper is licensed under the GPLv3.