Skip to main content

A Twitter client for the console.

Project description

A Twitter client for the console

A turses session with multiple columns running on urxvt:

http://alejandrogomez.github.com/img/turses_screenshot.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.

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.

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.

0.2.14

  • Daemonize threads so they finish when quitting turses

  • Fix a bug regarding SIGCONT handling

0.2.13

  • Y as shortcut for retweeting and favoriting a tweet

0.2.12

  • Upgrade to Tweepy 2.0 (hence Twitter API v1.1)

0.2.11

  • Include in_reply_to_status_id parameter in replies

0.2.10

  • Use HTTPS by default (thanks to Joe Di Castro)

0.2.9

  • Configurable number of statuses in user info widget

  • Sessions support

  • Better information for SSL errors

0.2.8

  • Python 2.6 support

0.2.7

  • center focus when receiving tweets after scrolling down the bottom

  • get your tweets that have been retweeted

0.2.6

  • configurable URL format

  • better browser integration (by Paul Ivanov)

0.2.5

  • search commands also available with no timelines

  • clear the status bar in every mode

  • asynchronous search timeline addition

  • keep columns when deleting a buffer within them

  • bugfix: crashed when deleting all buffers

0.2.4

  • bugfix: unable to focus the topmost status when having multiple columns

0.2.3

  • per-account configuration

  • bugfix: crashed when navigating to empty buffers

0.2.2

  • fix regression: timelines not updating periodically

0.2.1

  • bugfix: the Twitter entities were not processed every time

0.2.0

  • logging

0.1.18

  • bugfix: crash when rendering direct messages

0.1.17

  • developer docs

  • border around editor

  • bugfix: help and version were removed by stdout replacement

  • debug mode

  • offline debugging

0.1.16

  • show a popup with user info when pressing i

0.1.15

  • configurable editor alignment

  • make turses play nicely with terminal multiplexers (Joe Di Castro)

  • follow and unfollow users typing their nick in an editor (Giannis Damigos)

  • bugfix: pressing <Esc> in search user editor made turses crash

  • bugfix: avoid duplicate usernames in replies

0.1.14

  • bugfix: crash when shifting buffers to the beginning or end

0.1.13

  • bugfix: could not remove own retweets

  • bugfix: inconsistencies with help

0.1.12

  • bugfix: missing key binding in help (Giannis Damigos)

  • bugfix: status messages cleared the editor

  • configurable status bar visibility

  • changes to manual retweet template

  • set console title to turses

  • docs on readthedocs

0.1.11

  • bugfix: exception when marking tweet as favorite

0.1.10

  • expanded URLs for search results

  • bugfix: crashed when expanded URLs were missing

0.1.9

  • open focused status in a browser

  • show expanded URLs

0.1.8

  • bugfix: packaging error

0.1.7

  • bugfix: inconsistencies when navigating tweets with arrow keys

  • configurable status wrappers: box, divider or none

0.1.6

  • colored urls

  • colored favorites

  • bugfix: non-ascii characters on templates made turses crash

  • visual indicators for status types (retweet, reply, favorite)

0.1.5

  • configurable tab text

  • colored hashtags and usernames

0.1.4

  • update all timelines periodically

  • configurable default timelines

  • bugfix: don’t crash with empty timelines

  • bugfix: manual retweet crashed

  • bugfix: don’t capture all input

0.1.3

  • bugfix: packaging error

0.1.2

  • bugfix: error with packaging

0.1.1

  • bindings to update all timelines

  • bugfix: generate_token_file instead of create_token_file

0.1.0

  • binding to open focused status authors’ tweets

  • reload configuration

  • configuration default location and format changed

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

turses-0.2.14.tar.gz (51.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page