An interactive TLS-capable intercepting HTTP proxy for penetration testers and software developers.

debugging http http2 man-in-the-middle mitmproxy proxy python security ssl starred-mitmproxy-repo starred-repo tls websocket

Go to file

Maximilian Hils d6986d43cd Update release/README.md		2023-11-04 12:29:59 +01:00
.github	build macOS app bundle (#6447 )	2023-11-03 11:21:55 +00:00
docs	Migrate to ruff (#6433 )	2023-10-31 16:03:53 +01:00
examples	Migrate to ruff (#6433 )	2023-10-31 16:03:53 +01:00
mitmproxy	reopen main for development	2023-11-04 11:02:01 +00:00
release	Update release/README.md	2023-11-04 12:29:59 +01:00
test	Rename: osproxy -> local redirector (#6453 )	2023-11-04 10:52:18 +00:00
web	Strip double slash from websocket URL, fix #6452 (#6454 )	2023-11-04 11:00:22 +00:00
.gitattributes	test dumpfiles: .bin -> .mitm	2021-02-03 19:27:15 +01:00
.gitignore	update kaitai definitions	2022-07-29 16:13:15 +02:00
CHANGELOG.md	mitmproxy 10.1.3	2023-11-04 11:02:01 +00:00
CONTRIBUTING.md	Migrate to ruff (#6433 )	2023-10-31 16:03:53 +01:00
LICENSE	GPLv3 -> MIT	2013-03-18 08:37:42 +13:00
MANIFEST.in	remove pathod and pathoc	2020-12-13 20:21:11 +01:00
README.md	readme: fix nits	2022-12-15 17:50:43 +01:00
SECURITY.md	Create SECURITY.md	2021-09-13 16:34:33 +02:00
codecov.yml	remove `release/` from coverage	2022-07-25 01:39:04 +02:00
pyproject.toml	Rename: osproxy -> local redirector (#6453 )	2023-11-04 10:52:18 +00:00
setup.cfg	Migrate to ruff (#6433 )	2023-10-31 16:03:53 +01:00

README.md

mitmproxy

mitmproxy is an interactive, SSL/TLS-capable intercepting proxy with a console interface for HTTP/1, HTTP/2, and WebSockets.

mitmdump is the command-line version of mitmproxy. Think tcpdump for HTTP.

mitmweb is a web-based interface for mitmproxy.

Installation

The installation instructions are here. If you want to install from source, see CONTRIBUTING.md.

Documentation & Help

General information, tutorials, and precompiled binaries can be found on the mitmproxy website.

The documentation for mitmproxy is available on our website:

If you have questions on how to use mitmproxy, please use GitHub Discussions!

Contributing

As an open source project, mitmproxy welcomes contributions of all forms.

Also, please feel free to join our developer Slack! However, please note that the primary purpose of our Slack is direct communication between maintainers and contributors. If you have questions where the answer might be valuable to others, please use GitHub Discussions and not Slack.