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
The 1.5 Minute Guide to a Successful Install
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:
1) consumer key 2) consumer secret 3) access key 4) access secret
3-Step Installation instructions:
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.
What You Get
Twitter RSS Feeds
Favorites RSS Feed [
favoritesrss.php] + [
Home Timeline RSS Feed [
homerss.php] + [
User Lists RSS Feed [
listsrss.php] + [
User Timeline RSS Feed [
userrss.php] + [
Search RSS Feed [
searchrss.php] + [
Favorites JSON [
favoritesjson.php] + [
Home Timeline JSON [
homejson.php] + [
User Lists JSON [
listsjson.php] + [
User Timeline JSON [
userjson.php] + [
Search JSON [
searchjson.php] + + [
Pretty Printed JSON
Favorites Pretty Printed JSON [
favoritesjson_pp.php] + [
Home Timeline Pretty Printed JSON [
homejson_pp.php] + [
User Lists Pretty Printed JSON [
listsjson_pp.php] + [
User Timeline Pretty Printed JSON [
userjson_pp.php] + [
Search Pretty Printed JSON [
searchjson_pp.php] + [
Bugs & Questions
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