Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

TCP monitoring and logging tool with support for HTTP 1.1

Project Description

TCPWatch is a utility written in Python that lets you monitor forwarded TCP connections or HTTP proxy connections. It displays the sessions in a window with a history of past connections. It is useful for developing and debugging protocol implementations and web services.

Version 1.3 is compatible with Tkinter installations that use threads. See the change log for a list of other changes.

TCPWatch is licensed under ZPL 2.0 and requires Python 2.1 or later.

Version 1.3.1

  • Convert to use setuptools and console scripts for installation
  • Release to PyPI.

Version 1.3

  • Made compatible with versions of tcl that have threads enabled.
  • Log file numbers are now sequential.
  • user@host” is now accepted as a destination hostname (the user name is ignored).

Version 1.2.1

  • A typo made it impossible to use two of the command line options. Fixed.

Version 1.2

  • Added the ability to record TCP sessions to a directory. Use -r <path>. Implemented by Tres Seaver.
  • Replaced the launch script with a distutils, thanks again to Tres Seaver.

Version 1.1

  • Almost completely rewritten. The code is now more reusable and reliable, but the user interface has not changed much.
  • 8-bit clean. (You can now use TCPWatch to verify that SSH really does encrypt data. ;-) )
  • It can now run as a simple HTTP proxy server using the “-p” option. There are a lot of interesting ways to use this.
  • It’s now easier to watch persistent HTTP connections. The “-h” option shows each transaction in a separate entry.
  • You can turn off the Tkinter GUI using the -s option, which outputs to stdout.
  • Colorized Tkinter output.

Version 1.0

Never released to the public.

Release History

This version
History Node


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
(15.1 kB) Copy SHA256 Hash SHA256
Source None Jul 23, 2010

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting