total-connect-client

What it is and what it does

Total-Connect-Client is a Python wrapper around the TotalConnect2 alarm system API, designed primarily for Home Assistant integration but usable in any Python application. It handles OAuth authentication with TotalConnect servers and exposes methods to arm (away, stay, night modes), disarm, and query the status of alarm panels and individual zones. The package depends on pycryptodome for cryptographic operations and requests-oauthlib for OAuth token management.

The library is most useful for home automation scenarios where you want to control your alarm system programmatically or monitor zone faults (open sensors). It requires an active TotalConnect account and internet connectivity to both your alarm hardware and the TotalConnect cloud service. Zone fault detection requires that "Sensor Activities" be enabled in your TotalConnect account, which may incur an extra fee from your monitoring company.

Use it for:

• Integrate TotalConnect alarm control into Home Assistant automations for conditional arming based on presence or time
• Monitor alarm panel and zone status from a custom Python application or dashboard
• Arm/disarm your alarm system via command-line tools or scripts for scheduled or event-driven control
• Retrieve real-time zone fault status to trigger notifications when doors or windows are opened
• Build a standalone alarm management tool that doesn't rely on the TotalConnect web portal

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for authenticating with and controlling TotalConnect2 alarm systems, supporting arming/disarming and status queries.

Yes. The package is actively maintained, has no known vulnerabilities, installs with minimal friction, and is MIT-licensed. Install it if you need programmatic control of a TotalConnect alarm system from Python—particularly if you're building a Home Assistant integration or custom automation. The main constraint is that you must have an active TotalConnect account and reliable internet connectivity.

Install

total-connect-client on PyPI

pip install total-connect-client

uv add total-connect-client

poetry add total-connect-client

Installing total-connect-client

Before you install

Low friction installation with only two runtime dependencies (pycryptodome and requests-oauthlib). The package is actively maintained with a recent release (39 days old) and supports current Python versions (3.10–3.13).

License in practice

Licensed under MIT (permissive), so you can use, modify, and distribute this package with minimal legal restriction.

Quickstart

pip install total-connect-client

from total_connect_client.client import TotalConnectClient

client = TotalConnectClient(username='user@example.com', password='pass')
client.connect()
status = client.get_panel_status()
print(status)

Requires Python 3.10 or later and an active TotalConnect account with valid credentials. Internet connectivity to TotalConnect servers is required for all operations.

Verify before relying

• Whether the package handles TotalConnect API rate limits or retry logic automatically
• Whether offline operation or local fallback modes are supported
• Whether the package supports TotalConnect account types beyond standard residential systems

Package facts

Evidence: total_connect_client-2026.7-py3-none-any.whl

Keywords: alarm, TotalConnect

Tags

More Security packages