gtrchive

The Golang Twitter aRchive is a simple Go program to ingest Tweets and store them in RethinkDB.

Usage

The easist way to get up and running quickly is to use the official Docker image. Be sure to include your Twitter API credentials, as well as the keywords to track. See the official Twitter documentation for the keyword format.

docker run -it --rm \
    -e GTR_TWITTER_ACCESS_TOKEN=<SECRET> \
    -e GTR_TWITTER_ACCESS_SECRET=<SECRET> \
    -e GTR_TWITTER_CONSUMER_KEY=<SECRET> \
    -e GTR_TWITTER_CONSUMER_SECRET=<SECRET> \
    -e GTR_TWITTER_TRACK='foo bar,baz' \
    jmckind/gtrchive:latest

Development

Check out the source code locally and navigate to the directory.

git checout <REPO>/gtrchive.git
cd gtrchive

Next, ensure that the dependencies are present.

dep ensure

Set environment variables with Twitter credentials.

export GTR_TWITTER_ACCESS_TOKEN=<SECRET>
export GTR_TWITTER_ACCESS_SECRET=<SECRET>
export GTR_TWITTER_CONSUMER_KEY=<SECRET>
export GTR_TWITTER_CONSUMER_SECRET=<SECRET>

Set environment variable with keywords to track.

export GTR_TWITTER_TRACK='foo bar,baz'

Run the application.

go run gtrchive.go

Release

Build the Docker image.

docker build <REPO>/gtrchive:latest .

Run the Docker image locally.

docker run -it --rm -e <ENV VARS>... <REPO>/gtrchive:latest

License

gtrchive is released under the Apache 2.0 license. See the LICENSE file for details.