Edit on GitHub

# User Interface

First of all, we need to become familiar with mitmproxy’s user interface. Open the terminal window in which you started mitmproxy. You are in the default view of mitmproxy, which shows a list of flows. You should see your browser’s HTTP requests to load this tutorial. mitmproxy adds rows to the view as new requests come in.

Video Content

Welcome to the mitmproxy tutorial. In this lesson we cover the user interface.

This is the default view of mitmproxy.

mitmproxy adds rows to the view as new requests come in.

Let’s generate some requests using curl in a separate terminal.

Use curl’s --proxy option to configure mitmproxy as a proxy.

We use the text-based weather service wttr.in.

You see the requests to wttr.in in the list of flows.

mitmproxy is controlled using keyboard shortcuts.

Use your arrow keys ↑ and ↓ to change the focused flow (>>).

The focused flow (>>) is used as a target for various commands.

One such command shows the flow details, it is bound to ENTER.

Press ENTER to view the details of the focused flow.

The flow details view has 3 panes: request, response, and detail.

Use your arrow keys ← and → to switch between panes.

Press q to exit the current view.

Press ? to get a list of all available keyboard shortcuts.

Tip: Remember the ? shortcut. It works in every view.

Press q to exit the current view.

Each shortcut is internally bound to a command.

You can also execute commands directly (without using shortcuts).

Press : to open the command prompt at the bottom.

Enter console.view.flow @focus.

The command console.view.flow opens the details view for a flow.

The argument @focus defines the target flow.

Press ENTER to execute the command.

Commands unleash the full power of mitmproxy, i.e., to configure interceptions.

You now know basics of mitmproxy’s UI and how to control it.

In the next lesson you will learn to intercept flows.

In the next lesson, you will learn to intercept requests before sending them to the server.