{"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":"python","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,"search_vec":"'0.12.9':54 'access':21 'base':11 'cadenc':58 'command':45 'command-lin':44 'core':31 'current':51 'execut':38 'instal':16,36,70 'line':46 'logic':32 'mitm':68 'mitmproxi':2,5,23,29,42,63 'mitmproxy-r':22,41,62 'mitmproxy-window':1,4 'nativ':15 'network':66 'provid':13 'proxi':67 'python':10 'python-bas':9 'reimplement':27 'releas':57,65 'rs':24,43,64 'rust':26,72 'shim':12 'simplifi':34 'tie':60 'tool':47 'user':19 'version':52 'window':3,6,18,49,69 'wrapper':71","created_at":"2026-04-12T16:49:08.378363+00:00","updated_at":"2026-04-15T18:32:47.563206+00:00","problems":[{"fix":"Run mitmproxy with administrative privileges and specify an available port using the `-p` option, e.g., `mitmproxy -p 8081`.","cause":"This error occurs when mitmproxy attempts to bind to a port that is already in use or restricted by the system.","error":"Error starting proxy server: OSError(10013, 'An attempt was made to access a socket in a way forbidden by its access permissions', None, 10013, None)"},{"fix":"Ensure you are using Python 3 and install mitmproxy using `pip3 install mitmproxy`.","cause":"This error occurs when attempting to install mitmproxy with an incompatible Python version or missing dependencies.","error":"Command \"python setup.py egg_info\" failed with error code 1 in c:\\users\\sam\\appdata\\local\\temp\\pip-build-7emirj\\netlib"},{"fix":"Use an empty password when prompted during the certificate import process.","cause":"This error occurs when importing the mitmproxy certificate with an incorrect or empty password.","error":"CertUtil: -importPFX command FAILED: 0x80070056 (WIN32: 86 ERROR_INVALID_PASSWORD)"},{"fix":"Extract all files from the mitmproxy tarball before running the installation command.","cause":"This error occurs when attempting to install mitmproxy without extracting all files from the tarball.","error":"error: file 'E:\\mitmproxy-0.7\\mitmproxy' does not exist"},{"fix":"Run mitmproxy as an administrator, or start mitmproxy on a different, unused port using the `-p` flag (e.g., `mitmweb -p 8081`). You can check port usage with `netstat -na | findstr 8080`.","cause":"The default proxy port (usually 8080) that mitmproxy-windows tries to bind to is already in use by another application, or there are insufficient user permissions to bind to the port.","error":"OSError: [WinError 10013] An attempt was made to access a socket in a way forbidden by its access permissions"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"mitmproxy","cli_version":"sh: 1: mitmproxy: not found","type":"library","homepage":null,"github":"https://github.com/mitmproxy/mitmproxy-rs","docs":null,"changelog":null,"pypi":"https://pypi.org/project/mitmproxy-windows/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["http-networking"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-04-12","next_check":"2026-07-11","install_tag":null}}