A Twitter client for the console.
Python Makefile
Latest commit f0952f9 Aug 19, 2015 @dialelo Merge pull request #209 from cyphar/fix-broken-tweepy-api
tweepy: downgrade to working v3.1.0




A Twitter client for the console.

A session with multiple columns running on urxvt:


The goal of the project is to build a full-featured, lightweight, and extremely configurable Twitter client.


The documentation for turses is available on ReadTheDocs.

Take a look at this screencast for an overview of the features of turses and its usage.


If you downloaded the source code

$ python setup.py install

With pip

$ pip install turses

or (but consider using pip):

$ easy_install turses


  • Multiple timelines (buffers)
  • Multi-column
  • Tweet, Reply, Retweet, Delete tweet
  • Follow/Unfollow
  • Favorite/Unfavorite
  • Direct Messages
  • Open URLs in browser
  • Thread view
  • Unread count
  • Search
  • View any user's tweets
  • Fully customizable
  • Multiple accounts


The code is hosted on a git repo.

A list of tasks can be found on the on the issue tracker. Feel free to submit issues, feature requests or participate in ongoing discussions.

If you feel hackish, reading the dev docs is recommended.

CONTRIBUTING.md contains instructions on how to contribute code.


  • Lists
  • Streaming
  • Notifications


turses is licensed under a GPLv3 license, see LICENSE for details.


turses is based on Tyrs by Nicolas Paris.

See AUTHORS for a full list of contributors.