Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Flatworm logo

Flatworm is a proxy (simpler than a "Squid" :-P) that allows for easy bookkeeping while rewriting traffic. The original goal was to inject frames into YouTube videos as they went by if one were serving as a proxy for a network connection to It evolved into an attempt to build a general purpose system for mutating http traffic while also mutating the headers to be consistent with the mutated data.

This was an experiment I undertook in 2008. It started by being derived from version 0.6 of a simple C-based proxy server called 3Proxy, written by Vladimir Dubrovin (3APA3A):

I was looking for something that "just worked" and was easy enough to get my head around, as my knowledge of HTTP was not that detailed. I slowly evolved it from C into using C++-isms. Though I was not yet truly knowledgable about C++ in 2008, and was just starting to use the (now-deprecated) auto_ptr. Other oddities in there (for instance, I hadn't heard of boost::optional, but invented something similar called "knowable" to serve a similar purpose).

If I were to tackle something like this again today, I would want to build it using Boost.ASIO or perhaps a different language paradigm altogether, like Red. So I don't really suggest anyone use it, except possibly for educational purposes. I'm just archiving it on GitHub to get it off my hard drive, and to accompany an article and video.

The code has some pretty nuanced complexities to it, and I doubt there's anything out there that attacks quite the same problem. However, if this topic interests you, then you will almost certainly want to look at the "Man In The Middle Proxy":

In any case, I'll maintain some amount of documentation at the project's homepage, here:

Copyright (c) 2008 (- 2014?)

(3Proxy was licensed as BSD. So should anyone care for some reason, I'm licensing my modifications under those terms as well.)

(The Flatworm sketch I found on Google Images but could not determine the artist. I hope they don't mind me borrowing it for something that is gratis software and non-commercial in nature. If you drew it--or know who did--please let me know.)


Flatworm is a proxy (simpler than a "Squid" :-P) that allows for easy bookkeeping while rewriting traffic






No releases published


No packages published