Skip to content
A command-line twitter client with smart filtering and statistical classification
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Added tests for html_decode() Oct 18, 2010
README update README for oauth Aug 22, 2010
blacklist moved display code to a seperate module Aug 16, 2010
blacklist_users cleaning up forgotten details Aug 18, 2010 implemented oauth! Aug 22, 2010
ol error handling for missing settings file Sep 4, 2010


tc - Twitter Commander
(a tribute to


tc is a command-line twitter client with smart filtering and statistical classification.

 * whitelists for users whose content you always want to see and prioritize
 * blacklist for users you follow whose content you never want to see
 * blacklist for regular expressions to filter out of your stream entirely
 * topic classification (simple right now, I'm working on this)
 * search
 * the command-line UI rules the skool



mongodb - should be running on localhost (it's easy) -

Python packages:

pymongo - the python interface to mongo
tweepy - twitter API client
nltk - for simple topic classification and filtering


Install dependencies, and configure your username in Then, run If it's your first time, you'll
have to go through the oath authorization process.

===== - loads tweets from twitter and insert into the db. run this first. - twitter client
  -n # -- number of tweets to display (default = 10)
  -s time|antitime|rel|inf -- sort unread tweets by time (newest first), antitime (oldest first), rel (arbitrary relevance), inf ('influence' - using klout score) (default = time)
  -m -- don't mark displayed tweets as read (for debugging)
  -d -- print debug output to STDOUT (for debugging) - search tweets
  args -- search terms
  -n # - number of results to display (default = 10)
  -u val -- search username and user's name fields for val, display username and bio
You can’t perform that action at this time.