Skip to content

louipc/turses

Repository files navigation

turses

A Twitter client for the console.

A session with multiple columns running on urxvt:

./docs/images/turses_urxvt.png

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

Documentation

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.

Installation

If you downloaded the source code

$ python setup.py install

With pip

$ pip install turses

or (but consider using pip):

$ easy_install turses

Features

  • 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

Development

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.

Roadmap

  • Lists
  • Streaming
  • Notifications

License

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

Authors

turses is based on Tyrs by Nicolas Paris.

See AUTHORS for a full list of contributors.