Vert.x Twitter Wall

Live demo

Twitter Wall project for Vert.x. Streams tweets using Twitter4J through the SockJS event bus bridge. Uses mini.css and vue.js on the frontend.

Notes

When you first enter a hashtag, it acquires previous tweets using Twitter user authentication. Then, it switches to polling the Twitter API with app authentication (across all tracked hashtags, some content from less active ones may be skipped) and sends it to the client. Lastly, it upgrades to the Streaming API (we have to heavily rate limit this as Twitter does not like connection churn) to get realtime results for all hashtags. This usually happens within 2 seconds if new hashtags are added infrequently, with a 20-30 second worst case.

Usage

1. Build using mvn clean package
2. Move the JAR in /target to your preferred location
3. Fill in config.json (see Configuration section and config.example.json)
4. Move config.json to same directory as the JAR
5. Run java -jar vertx-twitter-wall-1.0-SNAPSHOT.jar -conf config.json
6. Visit localhost:<port in config>

Configuration

• The tokens and secrets can be obtained through these instructions.
• filterUpdateRateLimit is how many max stream reconnections to allow per second. Twitter does not document the rate limit for this. Don't change this without good reason.
• initialTweetRateLimit is how many lookups of initial tweets to allow per second using the user bucket. See https://dev.twitter.com/rest/public/rate-limits.
• searchPeriodInSeconds controls the period for the fallback search-based lookup using the app bucket. See https://dev.twitter.com/rest/public/rate-limits.

TODO

• Implement multiple hashtag tracking on the frontend