Skip to main content

Troll strangers!

Project description

Tromegle: Troll Strangers!
Tromegle started as a project through which to learn about HTTP requests and asynchronous I/O. The idea was
to learn how to use urllib(2) and later Twisted while having a bit of fun at the expense of a few [Omegle]( users, or "strangers".
It has since evolved into an unofficial API, complete with a simple client class.

###Trolling is a Art!
The nonstandard functionality of Tromegle is centered around a relatively simple [man-in-the-middle attack](

The power of Tromegle lies in the Transmogrifier class, which allows for the conditional modification or injection of AJAX events
and, by extension, user messages. In plain English, this means **you can modify the message a user sends to another**
as well as pass messages that only one user will see!

###Trolling gently
Sometimes it's just fun to evesdrop; internet users are often funny despite themselves. Tromegle gives you the
tools to either observe or record conversations, or relevant portions thereof.

Getting Tromegle
As of right now, the easiest way to obtain Tromegle is to clone this git repository with this command:

```git clone```

The package can then be installed withe the following commands:
cd tromegle
sudo python install

I do plan to release this library as a pip package when it leaves alpha.

Tromegle requires that you have the latest version of [Twisted]( installed.

Canonical installation instructions can be found on the above website, but the following installation steps
should work.

###Ubuntu (or other Debian-based distro)

```sudo apt-get install python-twisted```


Download the installer from [here][download]

###Any OS with pip installed (Mac/Win/*nix)

```pip install Twisted```


I don't own an Apple computer (too rich for my blood), but I understand that [OSX has shipped with Twisted pre-installed-ish since 2007][osx].
So, there's a good chance that this code works with zero setup - woohoo! If you happen to have an OSX box, please give it a shot
and let me know how it goes. Thanks!

If you have trouble with the OSX version of Twisted, try [downloading the tarball][download] and installing it to a different `PYTHONPATH` than the default.


Using Tromegle
So far, the MiddleMan class is the only attack that is working. More work will follow, including documentation.


import tromegle

m = tromegle.MiddleMan()

Project details

Download files

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

Source Distribution

tromegle-0.1.0.alpha.tar.gz (7.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page