Ubuntu comes with Python but we need to install pip, python-dev and several libraries. This was tested on a fully patched installation of Ubuntu 14.04.
$ sudo apt-get install python-pip python-dev libffi-dev libssl-dev libxml2-dev libxslt1-dev $ sudo pip install mitmproxy
Once installation is complete you can run mitmproxy or mitmdump from a terminal.
If you would like to install mitmproxy directly from the master branch on GitHub or would like to get set up to contribute to the project, install the dependencies as you would for a regular mitmproxy installation (see previous section). Then see the Hacking section of the README on GitHub.
The easiest way to get up and running on OSX is to download the pre-built binary packages from mitmproxy.org.
There are a few bits of customization you might want to do to make mitmproxy comfortable to use on OSX. The default color scheme is optimized for a dark background terminal, but you can select a palette for a light terminal background with the --palette option. You can use the OSX open program to create a simple and effective ~/.mailcap file to view request and response bodies:
application/*; /usr/bin/open -Wn %s audio/*; /usr/bin/open -Wn %s image/*; /usr/bin/open -Wn %s video/*; /usr/bin/open -Wn %s
Once installation is complete you can run mitmproxy or mitmdump from a terminal.
If you would like to install mitmproxy directly from the master branch on GitHub or would like to get set up to contribute to the project, ithere are a few OS X specific things to keep in mind.
Then see the Hacking section of the README on GitHub.
Please note that mitmdump is the only component of mitmproxy that is supported on Windows at the moment. There is no interactive user interface on Windows.
First, install the latest version of Python 2.7 from the Python website. If you already have an older version of Python 2.7 installed, make sure to install pip (pip is included in Python 2.7.9+ by default).
Next, add Python and the Python Scripts directory to your PATH variable. You can do this easily by running the following in powershell:
[Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Python27\;C:\Python27\Scripts\", "User")
Now, you can install mitmproxy by running
pip install mitmproxy
Once the installation is complete, you can run mitmdump from a command prompt.
If you would like to install mitmproxy directly from the master branch on GitHub or would like to get set up to contribute to the project, install Python as outlined above, then see the Hacking section of the README on GitHub.