Add -h and --help options
[tweeper.git] / 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 Example of use on the command line:
32
33   $ php tweeper.php http://twitter.com/NSACareers
34
35 Example of use as a Liferea[2] filter:
36
37   $ liferea-add-feed  "|php .../path_to_tweeper/tweeper.php http://twitter.com/NSAcareers"
38
39 [2] http://lzone.de/liferea/
40
41 Tweeper is licensed under the GPLv3.
42 Tweeper was written by Antonio Ospite http://ao2.it