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

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
tcpwatch-1.3.1.tar.gz (15.1 kB) Copy SHA256 Checksum SHA256 Source Jul 23, 2010

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting