A CallerID Application written in Python.


PyGCID (Which, by the way, means (Py)thon (G)TK (CID)) is a graphical application that will keep track of incoming calls on your telephone using some kind of hardware.

It will do this using an external program to read the incoming numbers, that way making it usable for a lot of different number-fetching hardware.

It will keep a small phonebook with a short and a long note about every number in a database.

Also using an external program it can call the numbers in the database. For example, you can use a DTMF-generator and hold your phone near your computer speakers. Yes, it works :-)


PyGCID is released under the GNU General Public License. Basically this means it's free to use.


To run PyGCID you need Python 1.5.2 with PyGTK 0.6.3 or greater. Python is available at and PyGTK can be found at


Version 0.01 is availabe here.


Not much at the moment. Please read the README and INSTALL files of the distribution.

The external program

As I mentioned earlier, PyGCID uses an external program to fetch the numbers.

The program should block until there is a number to read and put that number on standard input followed by a newline. After that it should exit, PyGCID will restart it.

Personally I use hardware that's specified at but with a slightly modified cidread.c available here. I've sent him a patch, so hopefully my additions will be integrated with the official version. My version just adds an option to output a newline after the number.


Yep. There's also a small window that popups when there's an incoming call. But I'm to lazy to make a shot out of that..