Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Shows tweets in terminal or on a simple web page

Project Description

Program that shows tweets pseudo-live in terminal.


All dependencies are specified in requirements.txt.

pip install -r requirements.txt


You can run Twitter Wall either in console or as a web page.


Before you can run the program, you have to create config file. There is a sample config file auth.cfg.sample. Create your own and set environment variable AUTH_FILE to path to that file.


$ terminaltwitterwall console --config auth.cfg --search "#python"


  • –search - Required. Search term to filter the tweets shown.
  • –count - Number of tweets initially loaded
  • –interval - Interval to load new tweets, in seconds
  • –ignore-retweets - Whether to ignore retweets in the output
  • –lang - Restrict tweets to the given language. Use [ISO 639-1 code](


$ terminaltwitterwall web


Tests are run by

$ python tests

If the auth file is specified, betamax will record new cassettes for tests. Otherwise the prepared ones are used.


Documentation is in docs folder. To generate html use the following command in docs directory:

$ make html

Release History

This version
History Node


History Node


History Node


History Node


History Node


Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting