Skip to main content

A simple twitter command line client

Project description


ptwit is a simple command-line-based Twitter client.




To install ptwit, simply:

$ pip install ptwit


For the first time you run ptwit command, you will be asked for your Twitter application information, which you can find at If you don’t have one, register at

You can also manually set your Twitter application information via the commands below:

$ ptwit config -g set consumer_key "CONSUMER KEY HERE"
$ ptwit config -g set consumer_secret "CONSUMER SECRET HERE"

ptwit supports multiple Twitter accounts. You can always use the login command to log into a new account:

$ ptwit login

The command above will take you to the Twitter authorization page, and ask you to give a name for this account.

You can easily switch between accounts you’ve already authorized:

$ ptwit login ACCOUNT

To remove an account from your computer, use this command:

$ ptwit config remove ACCOUNT

Twitter Commands

Get home timeline

$ ptwit timeline            # latest tweets
$ ptwit timeline -c 20      # latest 20 tweets

Get tweets of a Twitter user

$ ptwit tweets              # list your tweets
$ ptwit tweets USER         # list someone's tweets

Get mentions or replies

$ ptwit mentions
$ ptwit replies

Post a new tweet

$ ptwit post "YOUR STATUS"
$ ptwit post < tweet.txt

Send direct message

$ ptwit send USER "YOUR MESSAGE"
$ cat message.txt | ptwit send USER

List followings

$ ptwit followings

List followers

$ ptwit followers

Follow or unfollow Twitter users

$ ptwit follow USER
$ ptwit unfollow USER

List your favorite tweets

$ ptwit faves

Get a Twitter user’s information

$ ptwit whois USER

Search tweets

$ ptwit search TERM


ptwit is under the MIT License. See LICENSE file for full license text.

Project details

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
ptwit-0.0.7.tar.gz (8.6 kB) Copy SHA256 hash SHA256 Source None Jun 27, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page