Registry / http-networking / fritzconnection

fritzconnection

JSON →

library1.15.1pypypi✓ verified 88d ago

Library to communicate with AVM FRITZ!Box devices. Current version 1.15.1, Python >=3.7. Updated irregularly.

http-networking communication

pip install fritzconnection

github ↗package ↗

INSTALL

IMPORT

SIG · FRITZCONNECTION

fritzconnection

http-networkingpythonv1.15.1

Install

2.1s avg

Import

660ms

Disk

20MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.15.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.706s · 21.5MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.1s · import 0.614s · 22MB

20MB installed

● package 20MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FritzConnection

✓ from fritzconnection import FritzConnection

✗ from fritzconnection.core import FritzConnection

Direct import from package top-level is correct; core submodule is internal.

FritzHosts

✓ from fritzconnection.lib.fritzhosts import FritzHosts

✗ from fritzconnection import FritzHosts

Service classes are in fritzconnection.lib subpackage.

FritzStatus

✓ from fritzconnection.lib.fritzstatus import FritzStatus

✗ from fritzconnection.status import FritzStatus

Correct module is fritzconnection.lib.fritzstatus.

Connect to FRITZ!Box and get device info.

from fritzconnection import FritzConnection # Replace with your FRITZ!Box address, user, and password IP = '192.168.178.1' USER = 'admin' PASSWORD = 'your_password' fc = FritzConnection(address=IP, user=USER, password=PASSWORD) print(fc.call_action('DeviceInfo:1', 'GetInfo'))

fritzconnection --version

Debug

Known issues

gotchaDefault credentials fail: FRITZ!Box default user is 'admin' with a device-specific password. Not 'admin'/'password'.

fix

Use the password set in FRITZ!Box settings (System > FRITZ!Box Users).

affects: all

breakingIn version 1.0.0, the library was refactored: service classes moved from root package to fritzconnection.lib. Old imports like 'from fritzconnection import FritzStatus' break.

fix

Use: from fritzconnection.lib.fritzstatus import FritzStatus

affects: >=1.0.0

gotchaThe library may fail silently when the FRITZ!Box returns error codes (e.g., invalid action or service). Always check response status.

fix

Call action with 'check_error=True' or inspect response['error_code'].

affects: all

Errors

Common errors & fixes

ImportError: cannot import name 'FritzStatus' from 'fritzconnection'

FritzStatus was moved to fritzconnection.lib.fritzstatus after version 1.0.0.

fix

from fritzconnection.lib.fritzstatus import FritzStatus

fritzconnection.core.FritzConnectionException: 401 UNAUTHORIZED

Wrong username or password for FRITZ!Box.

fix

Verify credentials in FRITZ!Box settings. Default user is 'admin' with a custom password.

Upgrade

Version history

1.15.1latest on PyPI · released Jan 26, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

29 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/kbr/fritzconnection ↗

packagehttps://pypi.org/project/fritzconnection/ ↗