Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Python module and command line script client for
branch: master
Failed to load latest commit information.
.gitignore add .gitignore
README Make it work on Python 2.7 Bump version to 0.2.
urbandicli Fix pager support in Python 2.x Support new HTML markup



py-urbandict is a client for

Project page on github:


Just run:

  sudo install

To use it from command line, just use 'urbancli' tool like that:

$ urbandicli xterm
1. xterm
  Godly creature, omnipotent, guru in every way imaginable.
  * I wish i was an xterm


Usage from Python:

$ python3.2
Python 3.2 (r32:88445, Feb 27 2011, 09:51:00) 
[GCC 4.2.1 20070719  [FreeBSD]] on freebsd8
Type "help", "copyright", "credits" or "license" for more information.
>>> import urbandict
>>> urbandict.define('xterm')
[{'word': 'xterm', 'example': 'I wish i was an xterm', 'def': 'Godly creature, omnipotent, guru in every way imaginable.'}]

It returns list of defitinitions for a term. Each list item is a dict with the following keys:

 * word -- the word itself
 * def -- definition of the term
 * example -- example of its usage (could be empty)
Something went wrong with that request. Please try again.