{"id":4985,"library":"mitmproxy-windows","title":"mitmproxy-windows","description":"mitmproxy-windows is a Python-based shim providing a native installer for Windows users to access mitmproxy-rs, the Rust reimplementation of mitmproxy's core logic. It simplifies the installation and execution of the mitmproxy-rs command-line tool on Windows. The current version is 0.12.9, and its release cadence is tied to mitmproxy-rs releases.","status":"active","version":"0.12.9","language":"en","source_language":"en","source_url":"https://github.com/mitmproxy/mitmproxy-rs","tags":["network proxy","mitm","windows","installer","wrapper","rust"],"install":[{"cmd":"pip install mitmproxy-windows","lang":"bash","label":"Install"}],"dependencies":[],"imports":[],"quickstart":{"code":"# Install the shim (if not already done)\npip install mitmproxy-windows\n\n# After installation, run the mitmproxy-windows executable from your shell\n# To check the version:\n# mitmproxy-windows.exe --version\n\n# To start the proxy:\n# mitmproxy-windows.exe\n\n# You can use standard mitmproxy-rs CLI arguments, e.g., to run in headless mode:\n# mitmproxy-windows.exe --mode transparent --listen-host 127.0.0.1 --listen-port 8080","lang":"bash","description":"Installs the mitmproxy-windows shim and demonstrates how to run the underlying mitmproxy-rs executable it provides on Windows."},"warnings":[{"fix":"Do not attempt to `import mitmproxy_windows` in your Python code. Instead, install it and execute the `mitmproxy-windows.exe` command from your shell.","message":"This package is a Windows-specific installer/wrapper for `mitmproxy-rs`, not a Python library intended for programmatic import and use. Its primary function is to provide an executable (`mitmproxy-windows.exe`) on Windows systems.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Refer to the `mitmproxy-rs` documentation and GitHub repository for details on CLI arguments, features, and functionality.","message":"The core functionality and behavior are derived directly from the `mitmproxy-rs` project (written in Rust). While `mitmproxy-windows` simplifies its deployment, understanding `mitmproxy-rs` documentation is crucial for advanced usage and troubleshooting.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"For non-Windows systems, refer to the `mitmproxy-rs` documentation for alternative installation methods (e.g., building from source or using direct `mitmproxy-rs` binaries).","message":"The `mitmproxy-windows` package is specifically designed for Windows operating systems. It will not install or function correctly on macOS or Linux.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Always check the release notes for `mitmproxy-rs` when updating `mitmproxy-windows` to be aware of potential breaking changes.","message":"Breaking changes in the underlying `mitmproxy-rs` project (e.g., changes to CLI arguments, output formats, or core proxy behavior) will directly impact users of `mitmproxy-windows`.","severity":"breaking","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-12T00:00:00.000Z","next_check":"2026-07-11T00:00:00.000Z"}