Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…
Cannot retrieve contributors at this time
108 lines (72 sloc) 2.29 KB


A Twitter client for the console

A turses 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 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.

turses is evolving fast, 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.

To contribute code:
  1. Create a branch from develop
  2. Code following pep8 rules.
  3. Commit your changes
  4. Add yourself to AUTHORS
  5. Send a pull request to the develop branch

Any feedback is very much appreciated.


  • Lists
  • Streaming
  • Notifications
  • Sessions


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.

Jump to Line
Something went wrong with that request. Please try again.