turses

.. image:: https://api.travis-ci.org/dialelo/turses.png?branch=master

A Twitter client for the console.

A session with multiple columns running on urxvt:

.. image:: ./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 <http://turses.readthedocs.org>_.

Take a look at this screencast <http://www.youtube.com/watch?v=kmnEdldw7WY>_ 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

.. _consider using pip: http://www.pip-installer.org/en/latest/other-tools.html#pip-compared-to-easy-install

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_.

.. _git repo: http://github.com/louipc/turses

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.

.. _issue tracker: http://github.com/louipc/turses/issues

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

.. _dev docs: http://turses.readthedocs.org/en/latest/dev/internals.html

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_.

.. _Tyrs: http://tyrs.nicosphere.net .. _Nicolas Paris: http://github.com/Nic0

See AUTHORS for a full list of contributors.