Mobile performance engineering projects often require record and play functionality. JMeter has a very good Proxy Recorder, but there are other tools to help you overcome the challenges. One of these tools is mitmproxy.

Mitmproxy is a lightweight, fully capable proxy recorder. It has an interactive console and many functionalities to explore. We’ll do some basic stuff as an entry level tutorial.

How to Install mitmproxy

You can use the below command to install it.

 brew install mitmproxy 

It will download and install all the dependencies in a minute.

How to Start mitmproxy

Open a terminal screen. Enter “mitmproxy” and you’ll be welcomed by this screen.

As you can see, mitmproxy started listening to your request by its default port which is 8080. You can change the port with the below command.

 mitmproxy --listen--port #PORTNO 

Configure Your Mobile Device for Proxy

• Your mobile device needs to be on the same wireless network.
• Install mitmproxy’s certificate into your mobile device to capture HTTPS traffic.
• Set your mobile device's proxy settings as described in this blog post.
• Do any operation you want and get the recording.

• You can navigate the request by using up and down arrow buttons on your keyboard.
• You can enter one request’s detail by clicking on it.

Some Useful Commands

Writing the Output to a File

In the recording screen, press e, then select raw. It will ask you the location. Enter the location and anything related to that request (headers, body data, path, etc.)  will be saved into a file.

Return to the Main Console

Press : and write "console.view.pop." You’ll be directed back to the main console.

Clear Recording

Just click “z” to clear the mitmproxy console.

Replay the Request

Just click “r” to replay the request from the proxy.

There are many more commands that you can explore. Just type mitmproxy –commands before starting and browse all the commands.

Happy recording and load testing!