2020-12-13 15:14:13 +00:00
# mitmproxy
2021-03-16 15:17:27 +00:00
[![Continuous Integration Status ](https://github.com/mitmproxy/mitmproxy/workflows/CI/badge.svg?branch=main )](https://github.com/mitmproxy/mitmproxy/actions?query=branch%3Amain)
[![Coverage Status ](https://shields.mitmproxy.org/codecov/c/github/mitmproxy/mitmproxy/main.svg?label=codecov )](https://codecov.io/gh/mitmproxy/mitmproxy)
2020-12-13 15:14:13 +00:00
[![Latest Version ](https://shields.mitmproxy.org/pypi/v/mitmproxy.svg )](https://pypi.python.org/pypi/mitmproxy)
[![Supported Python versions ](https://shields.mitmproxy.org/pypi/pyversions/mitmproxy.svg )](https://pypi.python.org/pypi/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 ](https://docs.mitmproxy.org/stable/overview-installation ).
2021-01-04 06:09:35 +00:00
If you want to install from source, see [CONTRIBUTING.md ](./CONTRIBUTING.md ).
2020-12-13 15:14:13 +00:00
## Documentation & Help
General information, tutorials, and precompiled binaries can be found on the mitmproxy website.
[![mitmproxy.org ](https://shields.mitmproxy.org/badge/https%3A%2F%2F-mitmproxy.org-blue.svg )](https://mitmproxy.org/)
The documentation for mitmproxy is available on our website:
[![mitmproxy documentation stable ](https://shields.mitmproxy.org/badge/docs-stable-brightgreen.svg )](https://docs.mitmproxy.org/stable/)
2022-10-01 13:58:06 +00:00
[![mitmproxy documentation dev ](https://shields.mitmproxy.org/badge/docs-dev-brightgreen.svg )](https://docs.mitmproxy.org/dev/)
2020-12-13 15:14:13 +00:00
If you have questions on how to use mitmproxy, please
2021-11-16 09:26:38 +00:00
use GitHub Discussions!
2020-12-13 15:14:13 +00:00
2021-11-16 09:26:38 +00:00
[![mitmproxy discussions ](https://shields.mitmproxy.org/badge/help-github%20discussions-orange.svg )](https://github.com/mitmproxy/mitmproxy/discussions)
2020-12-13 15:14:13 +00:00
## Contributing
2021-03-11 18:13:02 +00:00
As an open source project, mitmproxy welcomes contributions of all forms.
2020-12-13 15:14:13 +00:00
[![Dev Guide ](https://shields.mitmproxy.org/badge/dev_docs-CONTRIBUTING.md-blue )](./CONTRIBUTING.md)
2022-10-14 06:19:55 +00:00
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 ](https://github.com/mitmproxy/mitmproxy/discussions ).
2020-12-13 15:14:13 +00:00
[![Slack Developer Chat ](https://shields.mitmproxy.org/badge/slack-mitmproxy-E01563.svg )](http://slack.mitmproxy.org/)