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