Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A command-line twitter client with smart filtering and statistical classification
Branch: master
Failed to load latest commit information.
classifiers updated fetch_data to user oath credentials (for gathering training d…
.gitignore .gitignore tweaks
README update README for oauth
blacklist moved display code to a seperate module
blacklist_users cleaning up forgotten details implemented oauth!
ol added link_cache from last set of displayed tweets and shell script t… added user search my username error handling for missing settings file quick script to allow *posting* to twitter. it's about time!


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
Something went wrong with that request. Please try again.