Easy access to Twitter RSS and JSON data
A PHP library that provides an incredibly easy way to access Twitter data as JSON, pretty printed JSON, or RSS feeds by URL or standard command line syntax. The Tweetledee files include caching to avoid exceeding the Twitter API v1.1 rate limits (see caveats in the documentation!).
- Docs Home: http://chrissimpkins.github.io/tweetledee
- Usage: http://chrissimpkins.github.io/tweetledee/usage.html
- Developer Docs: http://chrissimpkins.github.io/tweetledee/developer.html
- 0.4.2 : added support for inline images in all RSS scripts issue #51. A big thanks to Vinh Nguyen for his pull request to add support for this feature!
- 0.4.1 : added support for JSON pretty printing in PHP versions 5.3+ (from 5.4+ previously) issue #40. Thanks much to Martín Lucas Golini @SpartanJ for his new pretty printing functions.
- 0.4.0 : added caching to all Tweetledee files with default 90 sec duration. This default cache interval can be changed with the
cache_intervalURL parameter (with a value in seconds). Great big thanks to Christian Varga (@levymetal) for his contributions to this update! The non-cached versions of the files from v0.3.6 have been renamed with an appended
userrss_nocache.php) for anyone who would like to implement their own caching.
- 0.3.6 : bug fix for multi-parameter search query exception bug issue #30. Thanks much for the issue report @adjeD!
- 0.3.5 : bug fix for Twitter search filters issue #28. Thanks much for the issue report @molis83!
- 0.3.4 : added Python and Ruby wrappers for the Tweetledee files
- 0.3.3 : bug fixes for issue #15 & issue #16. Thanks much for the contributions from @jjschwartz, @kabookey, and @mikeklimczak.
- 0.3.2 : bug fixes for issue #14
$TLD_JS = 1in the file to activate this capability.
- 0.3.0 : You can now access Tweetledee from the command line locally or remotely via SSH and pipe the output to any application. Data is returned via the standard output stream when you access files with a terminal. Tweetledee will parse the parameters as standard command line switches. For single character parameters use short switches
-qand for multiple character parameters use long switches
- 0.2.9 : Added Twitter user lists RSS feeds
listsjson.php, pretty printed JSON
You will need the following:
Access via URL: PHP version 5.3 or higher
Access via command line: PHP version 5.3 or higher
libcurl installed (provides cURL - http://curl.haxx.se/libcurl/)
A Twitter application account from which you will obtain the:
- consumer key
- consumer secret
- access key
- access secret
Open the file on the path tweetledee > tldlib > keys > tweetledee_keys.php in any text editor and enter the information that you obtained from your Twitter app in the corresponding fields. Leave the single quotes around the alphanumeric strings that you enter.
Upload the 'tweetledee' directory (that is located in the directory where this README file resides) to the public facing directory on your web server. On many servers, this is the public_html directory
Kick the tires with the following test (it gives you a user timeline RSS feed for your account): http://[yourdomain]/tweetledee/userrss.php
That was easy... Go crazy, be good, have fun.
If you find a bug, please post it as a new issue on the GitHub repository with this information in your report.
Looking for support? Check this page.
MIT License - see the LICENSE.txt file in the source distribution