TTLock for Home Assistant (Marketplace integration)

Installs: 1.3k sharing analytics
GitHub stars: 157
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v0.17.1, October 25, 2026
Category: Security and safety, Locks and access
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: ttlock
Source: github.com/jbergler/hass-ttlock
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

TTLock is a Marketplace integration that connects TTLock based smart locks to Home Assistant through the vendor's cloud. It adds lock entities for locking and unlocking, along with sensors for battery, last operator and reason, and a signal strength sensor for each lock. It can also add and delete pass codes, list them, and show the history of lock and unlock records. Updates arrive through a webhook instead of regular polling, and a repair notice supplies the webhook address to register. Locks within range of Home Assistant's Bluetooth can report their state directly, and this can be turned off in the options so only the cloud is used. Setup is done in the UI with a vendor sign-in, and the options also cover poll interval and detail refresh interval.

Automatic summary of the README and code of jbergler/hass-ttlock. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Sign in with the vendor Connects through the vendor's own sign-in page.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Locks
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Login to TTLock

RegionThe TTLock cloud your account and developer app are registered with. EU / International covers everywhere except mainland China.
Password
Username

After setup

Poll intervalHow often to re-check whether each lock is locked or unlocked, in minutes.
Detail refresh intervalHow often to refresh slow-changing detail (battery, name, autolock and passage-mode config, gateway signal), in hours.
Read locks over BluetoothRead lock state directly from a lock in range of Home Assistant, instead of asking the TTLock cloud. Turn this off to use the cloud only.

Texts from the code of jbergler/hass-ttlock.

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Unable to generate webhook URL., Confirm your TTLock webhook URL, Register your TTLock webhook URL