turses 0.0.10

A Twitter client with a curses interface.

turses: a Twitter client written in Python
==========================================

A Twitter client with a curses interface written in Python. Various parts of the codebase
are borrowed from the `Tyrs`_ project by `Nicolas Paris`_.

.. _`Tyrs`: http://tyrs.nicosphere.net
.. _`Nicolas Paris`: http://github.com/Nic0

The goal of the project is to build a full-featured Twitter client:

- one that is fully customizable;
- usable with multiple UIs (curses, gtk, qt, etc.);
- plugged to different API backends (currently is using `python-twitter`_); and
- having all the Twitter API capabilities with some spice.

.. _`python-twitter`: http://code.google.com/p/python-twitter/

Installation
------------

**turses** is installed simply by: ::

$ pip install turses

or (but you should consider using pip): ::

$ easy_install turses

Features
--------

- Sexy curses interface
- Multiple timelines (buffers)
- Tweet, Reply, Retweet, Delete tweet
- Follow/Unfollow
- Favorite/Unfavorite
- Direct Messages
- Search
- View any user's tweets
- Fully customizable
- Multiple accounts
- Unread count

Roadmap
-------

- Documentation
- Thread view
- Lists
- Geo
- Blocking
- Improve settings

Development
-----------

**turses** is still a work in progress, a list of tasks can be found on
the TODO file. Eventually every task will reside in the repository's
`issue tracker`_.

.. _`issue tracker`: http://github.com/alejandrogomez/turses/issues

The branch in which I do most of the development is `develop`, I merge to `master`
when the code is ready for a release and I use extra branches for working in particular
tasks. If you want to hack with turses, branch-off `develop` or work there and
send a pull request.

Code
----

The code is hosted on `GitHub`_.

.. _`GitHub`: http://github.com/alejandrogomez/turses

Screenshots
-----------

.. image:: http://dialelo.com/img/turses_buffers.png

License
-------

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


0.0.10
-----
- unread count
- mark all tweets in active timeline as read
- fix (again) a bug with mouse events

0.0.9
-----
- compose tweet with same hashtags as the focused status
- create search timeline with hashtags from focused status

0.0.8
-----
- fix bug: self follow/unfollow
- fix bug: editor signals
- direct messages :)
- persistent timeline cursor

0.0.7
-----
- fix critical bug, missing dependency urwid

0.0.6
-----
- fix bug with mouse events
- relative imports to avoid `ImportError` exceptions

0.0.5
-----
- more colorful defaults
- see your own tweets
- search for a user's tweets

0.0.4
-----
- follow and unfollow
- pluggable UI and API
- associate callbacks to API calls

0.0.3
-----
- bug with non-ascii characters in search solved
- asynchronous API calls
- favorite/unfavorite tweets
- Favorites timeline

0.0.2
-----
- tests with coverage check
- fixed bug with missing dependency in `setup.py`
- decoration for tabs