README

   1 Tweeper is a web scraper which extracts the most recent public tweets of
   2 a given user from their home page on Twitter.com and formats them in RSS, so
   3 the information can be conveniently accessed and collected by a feed reader.
   4
   5 Since Jun 11th 2013 Twitter.com retired their API v1.0, so it's not possible
   6 to access a user timeline via RSS anymore, and it's also become mandatory to
   7 authenticate via OAuth to access this _public_ information in JSON format:
   8
   9   https://dev.twitter.com/discussions/16289
  10   https://dev.twitter.com/discussions/11564
  11
  12 Some services came up to overcome this "problem":
  13
  14   http://twss.55uk.net/
  15   http://twitter-rss.com/ (now redirecting to google.com)
  16   http://rssitfor.me
  17
  18 However these solutions are still shady and let no control to the user about
  19 who collects the information about the visited user timelines.
  20
  21 This is why Tweeper[1] was born, as an Open Source way to keep following your
  22 friends with a certain degree of anonymity, without having to tell Twitter.com
  23 whom you are friend to.
  24
  25 [1] http://www.urbandictionary.com/define.php?term=TWEEPER&defid=3743173
  26
  27 Tweeper can be used via web or as a command line program, for example as
  28 a filter in your feed reader, by passing the URL of the user's public timeline
  29 as the first argument.
  30
  31 Tweeper can easily scrape sites other than Twitter, it is just a matter of
  32 writing an xsl stylesheet for the transformation; an example for pump.io
  33 activity stream is provided in rss_converter_pump.io.xsl
  34
  35 Example of use on the command line:
  36
  37   $ php tweeper.php http://twitter.com/NSACareers
  38
  39 Example of use as a Liferea[2] filter:
  40
  41   $ liferea-add-feed  "|php .../path_to_tweeper/tweeper.php http://twitter.com/NSAcareers"
  42
  43 Example of use with identi.ca:
  44
  45   $ liferea-add-feed  "|php .../path_to_tweeper/tweeper.php http://identi.ca/evan"
  46
  47 [2] http://lzone.de/liferea/
  48
  49 Tweeper is licensed under the GPLv3.
  50 Tweeper was written by Antonio Ospite http://ao2.it