A Twitter client for the console.
Python Makefile
Latest commit b9992b7 Dec 30, 2016 @dialelo committed on GitHub Update HISTORY.rst




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.