miniupnpc
MiniUPnP IGD client
Decision gist · record as of 2026-08-14
Yes, if you need UPnP port mapping automation with an active UPnP router. The permissive BSD license and zero runtime dependencies make it low-risk. Medium install friction (compiled wheels) is manageable for the platforms covered. Aging maintenance is not a blocker for stable functionality, but verify upstream security status and Python version support for your use case before committing.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires an active UPnP-enabled Internet Gateway Device on the local network; will fail silently if none is present or UPnP is disabled on the router.
- Medium install friction due to compiled C extension wheels; prebuilt binaries available for common platforms.
- Last release 445 days ago; maintenance status is aging.
License · maintenance · safety
permissive license (permissive) — BSD 3-Clause License (permissive); allows commercial and private use with attribution and liability disclaimer. No restrictions on redistribution or modification.
last release 2025-05-26 (445 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 77,871 downloads/mo, #14,487 on PyPI
Alternatives
Verify before relying
import miniupnpc
upnp = miniupnpc.UPnP()
upnp.discover()
upnp.selectIGD()- Whether the package supports Python versions beyond those with prebuilt wheels.
- Current state of upstream MiniUPnPc library and any known security advisories not yet reflected in OSV.
- Whether the aging maintenance status reflects active upstream development or stable/dormant state.
What it is and what it does
miniupnpc is a Python binding to the MiniUPnPc C library, which implements the UPnP Control Point protocol for communicating with UPnP Internet Gateway Devices (routers). It allows Python applications to discover UPnP devices on the local network, query their capabilities, and manage port mappings—useful for applications that need to open ports for incoming connections without manual router configuration.
The package is designed for low footprint with minimal dependencies (libc only in the C layer). It ships as precompiled wheels across Linux, macOS, and Windows architectures. No runtime Python dependencies are required. The library has been maintained since 2005 in its C form, though the Python binding itself shows aging maintenance signals (last release 445 days ago).
Use it for
- Peer-to-peer applications that need to automatically open inbound ports on the user's router for NAT traversal.
- Home automation or IoT applications discovering and controlling UPnP devices on a local network.
- Network diagnostic tools querying router capabilities and current port mapping configuration.
- BitTorrent or file-sharing clients automating port forwarding setup without user intervention.
- Game servers or streaming applications requesting temporary port mappings from the gateway device.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need UPnP port mapping automation with an active UPnP router.
The permissive BSD license and zero runtime dependencies make it low-risk. Medium install friction (compiled wheels) is manageable for the platforms covered. Aging maintenance is not a blocker for stable functionality, but verify upstream security status and Python version support for your use case before committing.
Install
miniupnpc on PyPI
Before you install
Medium install friction due to compiled C extension wheels; prebuilt binaries available for common platforms. Last release 445 days ago; maintenance status is aging.
Requires an active UPnP-enabled Internet Gateway Device on the local network; will fail silently if none is present or UPnP is disabled on the router.
License in practice
BSD 3-Clause License (permissive); allows commercial and private use with attribution and liability disclaimer. No restrictions on redistribution or modification.
Quickstart
import miniupnpc
upnp = miniupnpc.UPnP()
upnp.discover()
upnp.selectIGD()Verify before relying
- Whether the package supports Python versions beyond those with prebuilt wheels.
- Current state of upstream MiniUPnPc library and any known security advisories not yet reflected in OSV.
- Whether the aging maintenance status reflects active upstream development or stable/dormant state.
Package facts
| License | permissive license permissive |
| Python support | Not specified |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Aging 445 days since the last release |
| First released | |
| Downloads | 77,871 / month, #14,487 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: miniupnpc-2.3.3-cp310-cp310-macosx_13_0_arm64.whl; miniupnpc-2.3.3-cp310-cp310-macosx_13_0_universal2.whl; miniupnpc-2.3.3-cp310-cp310-macosx_13_0_x86_64.whl; miniupnpc-2.3.3-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl; miniupnpc-2.3.3-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; miniupnpc-2.3.3-cp310-cp310-win32.whl; miniupnpc-2.3.3-cp310-cp310-win_amd64.whl; miniupnpc-2.3.3-cp311-cp311-macosx_13_0_arm64.whl; miniupnpc-2.3.3-cp311-cp311-macosx_13_0_universal2.whl; miniupnpc-2.3.3-cp311-cp311-macosx_13_0_x86_64.whl; miniupnpc-2.3.3-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; miniupnpc-2.3.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; miniupnpc-2.3.3-cp311-cp311-win32.whl; miniupnpc-2.3.3-cp311-cp311-win_amd64.whl; miniupnpc-2.3.3-cp312-cp312-macosx_13_0_arm64.whl; miniupnpc-2.3.3-cp312-cp312-macosx_13_0_universal2.whl; miniupnpc-2.3.3-cp312-cp312-macosx_13_0_x86_64.whl; miniupnpc-2.3.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; miniupnpc-2.3.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; miniupnpc-2.3.3-cp312-cp312-win32.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “upnp port mapping”
- miniupnpcPython binding for MiniUPnPc library that enables applications to…
- async-upnp-clientAsync UPnP client library for discovering, controlling, and eventing…
- python-didl-liteReads and writes DIDL-Lite XML documents, a standard format for…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also async-upnp-client · python-songpal · midea-local · wiim · btsocket · broadlink · elasticsearch5 · tinytuya · pyudev · libsoundtouch