Skip to main content

An API and command-line toolset for Twitter (

Project description

Python Twitter Tools

The Minimalist Twitter API for Python is a Python API for Twitter, everyone’s favorite Web 2.0 Facebook-style status updater for people on the go.

Also included is a twitter command-line tool for getting your friends’ tweets and setting your own tweet from the safety and security of your favorite shell and an IRC bot that can announce Twitter updates to an IRC channel.

For more information, after installing the twitter package:

  • import the twitter package and run help() on it
  • run twitter -h for command-line tool help
  • run twitterbot -h for IRC bot help
  • visit for more info

The Command-Line Tool

The command-line tool currently supports the following things:

  • view your friends’ recent tweets
  • view your recent replies
  • view the public timeline
  • follow and unfollow (leave) friends
  • view tweets from lists
  • various output formats for tweet information
  • read your username and password from a config file

The bottom line: type twitter, receive tweets.

The IRC Bot

The IRC bot is associated with a twitter account (either your own account or an account you create for the bot). The bot announces all tweets from friends it is following. It can be made to follow or leave friends through IRC /msg commands.


twitter-log is a simple command-line tool that dumps all public tweets from a given user in a simple text format. It is useful to get a complete offsite backup of all your tweets. Run twitter-log and read the instructions.

Python Twitter Tools are released under an MIT License.

Project details

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
twitter-1.7-py2.7.egg (55.0 kB) Copy SHA256 hash SHA256 Egg 2.7
twitter-1.7.tar.gz (21.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

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