---
id: fritzconnection
version: "1.15.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# fritzconnection — Communicate with the AVM FRITZ!Box

License: permissive · Maintenance: active · Downloads: 136.6K/mo

## What it is and what it does

fritzconnection is a Python client library for communicating with AVM FRITZ!Box routers using their TR-064 and HTTP APIs. It abstracts the complexity of these protocols, allowing you to execute router actions (network settings, status queries, home automation control) and retrieve device data through simple method calls. The library handles API inspection on startup, converting responses to native Python types, and optionally caches model-specific API metadata to speed up initialization.

The package is designed for developers building automation, monitoring, or integration tools around FRITZ!Box hardware. It supports both synchronous operations and provides library modules that simplify common tasks. Credentials can be sourced from environment variables, and the caching mechanism helps when creating multiple instances or running in resource-constrained environments.

Use it for:

- Automate network tasks like forcing IP renewal or managing port forwarding on a FRITZ!Box router
- Monitor and control home automation devices (lights, switches, thermostats) connected to a FRITZ!Box
- Retrieve device statistics and status information from smart home devices registered with the router
- Integrate FRITZ!Box management into larger home automation or monitoring dashboards
- Build call-monitoring applications that track or log incoming/outgoing calls on the router

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Communicate with AVM FRITZ!Box routers via TR-064 and HTTP interfaces, supporting network management, home automation device control, and call monitoring.

Yes. The package is actively maintained, has no known vulnerabilities, carries a permissive MIT license, and installs with minimal friction. It's well-suited for anyone building FRITZ!Box automation or home automation integrations in Python. The broad Python version support (3.7–3.14) and caching feature make it practical for both simple scripts and production systems.

## Install

pip install fritzconnection
uv add fritzconnection
poetry add fritzconnection

## Installing fritzconnection

Before you install: Low install friction with a single runtime dependency (requests). Active maintenance with recent commits and a stable production status; supports Python 3.7 through 3.14.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both personal and commercial projects.

Quickstart:

pip install fritzconnection

from fritzconnection import FritzConnection

fc = FritzConnection(address="192.168.178.1", user="user", password="pw")
fc.call_action("WANIPConn1", "ForceTermination")

Requires network access to a FRITZ!Box router; credentials (username/password) can be read from FRITZ_USERNAME and FRITZ_PASSWORD environment variables to avoid hardcoding.

Verify before relying:

- Whether the optional segno dependency (for QR-code generation) is needed for your use case
- Performance characteristics when managing many home automation devices simultaneously
- Compatibility with specific FRITZ!Box models or firmware versions beyond the documented API

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 136.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

fritz box router control, TR-064 protocol python, home automation device management, fritz box api client, AVM router automation, call monitoring fritz box, smart home device control, home-automation, router-management, device-control

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