total-connect-client
Interact with Total Connect 2 alarm systems
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later and an active TotalConnect account with valid credentials.
- Internet connectivity to TotalConnect servers is required for all operations.
- Low friction installation with only two runtime dependencies (pycryptodome and requests-oauthlib).
License · maintenance · safety
MIT (permissive) — Licensed under MIT (permissive), so you can use, modify, and distribute this package with minimal legal restriction.
last release 2026-07-06 (39 days) · last repo commit 2026-07-06 · 14 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 75,492 downloads/mo, #14,706 on PyPI
Alternatives
Verify before relying
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)- 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
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 on it.
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
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).
Requires Python 3.10 or later and an active TotalConnect account with valid credentials. Internet connectivity to TotalConnect servers is required for all operations.
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)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
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagespycryptodomerequests-oauthlib |
| Maintenance | Actively maintained 39 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 75,492 / month, #14,706 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Topic :: Home AutomationTopic :: Security |
Evidence: total_connect_client-2026.7-py3-none-any.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 › “totalconnect alarm system client”
- total-connect-clientA Python client library for authenticating with and controlling…
- pyriscoPyrisco provides an async Python interface to Risco alarm systems via…
- jaraco.abodeA Python library that interfaces with the Abode home security system…
Give your agent the search over MCP, or paste the wish link into any chat.
More Security packages
Provides Python bindings to the FreeDesktop.org Secret Service API for securely storing and retrieving passwords and secrets through GNOME Keyring, KWallet, or KeePassXC.
MSAL for Python handles OAuth2 and OpenID Connect authentication with Microsoft identity services, managing token acquisition, caching, and refresh for applications integrating with Microsoft Entra ID, Microsoft Accounts, and Azure AD B2C.
joserfc implements JOSE standards (JWS, JWE, JWK, JWT, and related RFCs) for signing, encrypting, and managing JSON-based cryptographic tokens in Python.
Authlib provides a complete implementation of OAuth 1.0, OAuth 2.0, and OpenID Connect 1.0 for building both authentication clients and servers, with built-in support for JWS, JWK, JWA, and JWT standards.
Provides low-level CFFI bindings to the official Argon2 password hashing algorithm for use by libraries and applications that need direct access to Argon2 without higher-level abstractions.
ADAL for Python authenticates applications with Azure Active Directory to obtain tokens for accessing Azure AD-protected resources.
Install only if maintaining existing code that already depends on it, and plan a migration.
See also elkm1-lib · pyrisco · adext · systembridgeconnector · ha-garmin · elmax-api · jaraco.abode · pysma · yalexs · homematicip