greptweet/README.md

http://greptweet.com

• Uses HTML offline feature
• Aims to suck less by keeping lines of code low
• Dependencies: PHP, curl
• Look and feel by http://twitter.github.com/bootstrap
• Please review and comment on the code!

Known limitations

• API only allows 3200 tweets to be downloaded this way at one time :(
• 300 API limit using a Application only Auth bearer token (which doesn't seem to expire...)
• Won't work on protected accounts (duh!)
• No @mentions or DMs from other accounts

API

Fetch your tweets manually by accessing the URL:

http://greptweet.com/f/TWITTER_USERNAME

Last 4 tweets:

curl -s http://greptweet.com/u/webconverger/tweets.txt | head -n4

Getting a Bearer Token

When you clone and attempt to run this opensource project you will notice that you are missing a secret.php file, this file contains one setting $bearer_token. To create a bearer token:

1. Create a new Twitter app

2. Under OAuth settings, make a note of the Consumer key and Consumer secret

3. Now retrieve the bearer token by building a request with curl:

   curl -X POST --verbose "https://api.twitter.com/oauth2/token" -d "grant_type=client_credentials" -u consumerKey:consumerSecret

The response should end like:

{"access_token":"SECRETEXAMPLESTRING","token_type":"bearer"}

Save that SECRETEXAMPLESTRING to secret.php:

<?php
$bearer_token = 'SECRETEXAMPLESTRING';
?>

nginx configuration

See https://github.com/kaihendry/greptweet/blob/master/nginx.conf

Daily backup

http://backup.greptweet.com/tweets.tar

@daily cd /srv/www/greptweet.com && git describe --always > version.txt
@daily find /srv/www/greptweet.com/u/ -name '*.gz' -type f -print0 | tar cf /srv/www/backup.greptweet.com/tweets.tar --null -T -