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.

Flattr Tweetledee!

• 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.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
• 0.3.1 : Updated all standard JSON files with cross site access to your Twitter JSON data from client side JavaScript code (sets the Access-Control-Allow-Origin header to accept all connections, i.e. cross origin resource sharing). Defaults to off. Set the flag $TLD_JS = 1 in 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 -q and for multiple character parameters use long switches --user.
• 0.2.9 : Added Twitter user lists RSS feeds listsrss.php, JSON listsjson.php, pretty printed JSON listsjson_pp.php

You will need the following:

• Access via URL: PHP version 5.3 or higher (5.4 or higher for pretty printed JSON)

• Access via command line: PHP version 5.3 or higher (5.4 or higher for pretty printed JSON)

• 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

1. 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.

2. 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

3. 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.

Tweetledee Usage Examples

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.

If you would like to contribute to the project, by all means, please do so. Fork the Tweetledee development branch and submit a pull request back to the repository.

MIT License - see the LICENSE.txt file in the source distribution

✪ Chris