Skip to main content

Async Python client for the Verisure Italy alarm API

Project description

Verisure Italy for Home Assistant

Home Assistant custom component for Verisure Italy alarm systems.

Talks directly to customers.verisure.it/owa-api/graphql. Fully replaces the Verisure mobile app for alarm control and monitoring.

Not affiliated with Verisure Group or Securitas Direct.

Installation (HACS)

  1. Open HACS in Home Assistant
  2. Click ... (top right) → Custom repositories
  3. Add https://github.com/vjt/ha-verisure as Integration
  4. Search for "Verisure Italy" and install
  5. Restart Home Assistant
  6. Go to Settings → Devices & Services → Add Integration → Verisure Italy

The API client (verisure-italy) is installed automatically from PyPI.

Features

  • Passive polling via xSStatus — no panel ping, no timeline spam
  • Arm/disarm — partial+perimeter (home), total+perimeter (away)
  • Force arm — open zone detection with verisure_italy_arming_exception event and verisure_italy.force_arm service
  • Config flow with 2FA/OTP support
  • Configurable poll interval (default 5 seconds)

Alarm State Mapping

Panel State Proto HA State Action
Disarmed D Disarmed disarm
Partial + Perimeter B Armed Home arm_home
Total + Perimeter A Armed Away arm_away
Perimeter only E Armed Custom Bypass display only
Partial (no peri) P Armed Custom Bypass display only
Total (no peri) T Armed Custom Bypass display only

Development

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

pytest tests/ -x -q                                # 118 tests
pyright verisure_italy/ custom_components/          # strict mode, 0 errors
ruff check verisure_italy/ tests/ custom_components/

License

MIT. See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

verisure_italy-0.3.1.tar.gz (26.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

verisure_italy-0.3.1-py3-none-any.whl (18.1 kB view details)

Uploaded Python 3

File details

Details for the file verisure_italy-0.3.1.tar.gz.

File metadata

  • Download URL: verisure_italy-0.3.1.tar.gz
  • Upload date:
  • Size: 26.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for verisure_italy-0.3.1.tar.gz
Algorithm Hash digest
SHA256 30c7f9ca9544e9812d6bb28e1e9f115e780835e1c7ac6f3f3822f865942254ab
MD5 711946f9c7a2369abe572399e2a763d9
BLAKE2b-256 df38b42a9697f606514e5f94bed86eaed31c4564c8c0f3b0ce7da5f01e0b883b

See more details on using hashes here.

File details

Details for the file verisure_italy-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: verisure_italy-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 18.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for verisure_italy-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b8e2e994e48ab2b793c2b6ae3dadf14a15896dc768be394866dbdebae8e82709
MD5 9ec8bd96e8d8ac6cadd77832ec39827a
BLAKE2b-256 3e17d91b5a2baa1c4461c154a12ad5ad76ddc16fc83e70b4ce6259bdf0849625

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page