---
id: miniupnpc
version: "2.3.3"
license: BSD 3-Clause License Copyright (c) 2005-2025, Thomas BERNARD All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the… (full text in the JSON record)
license_treatment: permissive
maintenance: aging
---

# miniupnpc — MiniUPnP IGD client

License: permissive · Maintenance: aging · Downloads: 77.9K/mo

## 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 above — verify before relying.

Python binding for MiniUPnPc library that enables applications to communicate with UPnP Internet Gateway Devices on the network to manage port mappings and network configuration.

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

pip install miniupnpc
uv add miniupnpc
poetry add miniupnpc

## Installing miniupnpc

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.

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()

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.

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: BSD 3-Clause License Copyright (c) 2005-2025, Thomas BERNARD All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the… (full text in the JSON record) (permissive)
- Python support: unspecified
- Install friction: medium
- Maintenance: aging
- Downloads: 77.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

upnp port mapping, internet gateway device control, upnp client library, nat traversal python, miniupnp binding, upnp control point, network device discovery, nat-traversal, upnp, network-automation

[View on SkillFed](https://skillfed.io/packages/miniupnpc) · [View on PyPI](https://pypi.org/project/miniupnpc/)