Registry / http-networking / mitmproxy-windows

mitmproxy-windows

JSON →
library0.12.9pypypiunverified

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.

pip install mitmproxy-windows
INSTALL
IMPORT
SIG · MITMPROXY-WINDOWS
M
mitmproxy-windows
http-networkingpythonv0.12.9
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Installs the mitmproxy-windows shim and demonstrates how to run the underlying mitmproxy-rs executable it provides on Windows.

# Install the shim (if not already done) pip install mitmproxy-windows # After installation, run the mitmproxy-windows executable from your shell # To check the version: # mitmproxy-windows.exe --version # To start the proxy: # mitmproxy-windows.exe # You can use standard mitmproxy-rs CLI arguments, e.g., to run in headless mode: # mitmproxy-windows.exe --mode transparent --listen-host 127.0.0.1 --listen-port 8080
mitmproxy --version
Debug
Known issues
gotchaThis 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.
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.
affects: >=0.1.0
gotchaThe 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.
fix
Refer to the `mitmproxy-rs` documentation and GitHub repository for details on CLI arguments, features, and functionality.
affects: >=0.1.0
gotchaThe `mitmproxy-windows` package is specifically designed for Windows operating systems. It will not install or function correctly on macOS or Linux.
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).
affects: >=0.1.0
breakingBreaking 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`.
fix
Always check the release notes for `mitmproxy-rs` when updating `mitmproxy-windows` to be aware of potential breaking changes.
affects: All versions
Errors
Common errors & fixes
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)
This error occurs when mitmproxy attempts to bind to a port that is already in use or restricted by the system.
fix
Run mitmproxy with administrative privileges and specify an available port using the `-p` option, e.g., `mitmproxy -p 8081`.
Command "python setup.py egg_info" failed with error code 1 in c:\users\sam\appdata\local\temp\pip-build-7emirj\netlib
This error occurs when attempting to install mitmproxy with an incompatible Python version or missing dependencies.
fix
Ensure you are using Python 3 and install mitmproxy using `pip3 install mitmproxy`.
CertUtil: -importPFX command FAILED: 0x80070056 (WIN32: 86 ERROR_INVALID_PASSWORD)
This error occurs when importing the mitmproxy certificate with an incorrect or empty password.
fix
Use an empty password when prompted during the certificate import process.
error: file 'E:\mitmproxy-0.7\mitmproxy' does not exist
This error occurs when attempting to install mitmproxy without extracting all files from the tarball.
fix
Extract all files from the mitmproxy tarball before running the installation command.
OSError: [WinError 10013] An attempt was made to access a socket in a way forbidden by its access permissions
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.
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`.
Upgrade
Version history
0.12.9latest on PyPI · released Jan 30, 2026
Audit
Dependencies

No dependency data recorded yet.

Agent activity
6 hits · last 30 days
node
4
OpenAI (training)
1
Resources
mitmproxy-windows — pip install mitmproxy-windows · libregistry