PlayFramework 2.x module to fetch, cache, and display tweets from Twitter
Java Scala ApacheConf HTML Other
Clone or download
Latest commit 9a732f2 Mar 13, 2015
Failed to load latest commit information.
module Prepped for 2.2.0 release Feb 5, 2015
sample Added Scala sample Mar 13, 2015
.gitignore working module Jul 12, 2013 Added Scala sample Mar 13, 2015 Updated docs Feb 5, 2015

Twitter for PlayFramework


Play Framework 2.x. to fetch, cache, and display tweets from Twitter. Resilient against Twitter API downtime by maintaining a cached copy of the last successful API call. Basic rendering of tweets into html for simple display -- or using the advanced object model to render your own.

Compatibility matrix

PlayFramework version Module version
2.3.x 2.2.0
2.2.x 2.1.0
2.1.x 2.0.1


This module is published to Maven Central. You will need to include the module in your dependencies list, in build.sbt or Build.scala file:


libraryDependencies ++= Seq(
  "com.fizzed" %% "fizzed-play-module-twitter" % "2.2.0"


import sbt._
import Keys._
import play.Project._

object ApplicationBuild extends Build {

  val appName         = "sample"
  val appVersion      = "1.0-SNAPSHOT"

  val appDependencies = Seq(
    "com.fizzed" %% "fizzed-play-module-twitter" % "2.2.0"



Create this configuration file if it doesn't exist. Add this line to activate the plugin at runtime.


twitter.access-token = "required: replace with twitter access token"
twitter.access-secret =  "required: replace with twitter access secret"
twitter.consumer-key = "required: replace with twitter consumer key"
twitter.consumer-secret = "required: replace with twitter consumer secret"
twitter.refresh-interval = 60m

From a Java-based controller

See fizzed-java-sample project for full example.

package controllers;


import play.*;
import play.mvc.*;

public class Application extends Controller {
    static public TwitterPlugin TWITTER_PLUGIN = Play.application().plugin(TwitterPlugin.class);
    public static Result index() {
        return ok(views.html.index.render());
    public static TwitterPlugin twitter() {
    	return TWITTER_PLUGIN;

From a Scala-based controller

See fizzed-scala-sample project for full example.

package controllers


import play.api._
import play.api.mvc._

object Application extends Controller {

  val TWITTER_PLUGIN = Play.current.plugin[TwitterPlugin]

  def index = Action {
    Ok(views.html.index("Fizzed Twitter Module Sample"))