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](http://omegle.com) 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](http://en.wikipedia.org/wiki/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!
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.
You will need python version 2.7 or later to use Tromegle. 2.6 will not work because Tromegle makes extensive use
of dictionary comprehension syntax -- a feature added in python2.7.
###Installing through pip
As of right now, the easiest way to obtain Tromegle is through pip. Make sure pip is installed prior to running:
```pip install tromegle --user```
### Installing through Git
```git clone https://github.com/louist87/tromegle.git```
The package can then be installed withe the following commands:
sudo python setup.py install
Tromegle is maintained and tested on the latest version of [Twisted](http://twistedmatrix.com/) It is very likely to
continue working with older versions, however.
Canonical installation instructions can be found on the above website, but the following installation steps
###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```
OSX has shipped with Twisted preinstalled since 2007, so Tromegle should work out-of-the-box! If you have any trouble, you should try [this simple procedure](http://twistedmatrix.com/trac/wiki/FrequentlyAskedQuestions#WhyamIgettingImportErrorsforTwistedsubpackagesonOSX10.5)
If that doesn't work, you can try [downloading the tarball][download] and installing it to a different `PYTHONPATH` than the default.
Instructions on how to use Tromegle can be found in the [short and sweet introduction to Tromegle](http://github.com/louist87/tromegle/wiki/Short-and-Sweet-Introduction-to-Tromegle) wiki page.
TODO: Brief introduction on what you do with files - including link to relevant help section.