Skip to main content

pyEzvizApi

CI PyPI Buy Me A Coffee

A Python client and CLI for the reverse-engineered EZVIZ cloud API, device controls, channel-99 push and optional local/cloud media processing.

These docs track main, including unreleased changes. A PyPI installation may not contain every API described here. Match documentation to your installed release tag, or use a source checkout for current development. See the changelog, especially the removed import paths and push migration.

Upgrading to 2.0

Version 2.0 removes obsolete flat imports and legacy push registration. Review the release and migration notes before upgrading. Push consumers need explicit channel-99 migration and durable complete-token storage; polling remains independent of push. Updating this library does not migrate Home Assistant integrations or change their dependency pins.

Install

Python 3.12 or newer is required for the library.

python -m pip install pyezvizapi
# Optional PyAV-backed streaming APIs:
python -m pip install 'pyezvizapi[streaming]'

FFmpeg/FFprobe are separate system programs used by specific media paths, not installed by pip. Home Assistant and development-player dependencies are not required for ordinary library use.

Quick start

pyezvizapi --help
# First login; replace placeholders. Passwords passed as arguments may be
# visible in shell history/process listings. Prefer saved tokens for reuse.
pyezvizapi -u YOUR_USERNAME -p YOUR_PASSWORD --save-token devices status
# Global flags precede the command:
pyezvizapi --token-file ezviz_token.json --json devices status

The CLI prompts for MFA when required. Protect the complete token file; do not commit it. See getting started for region selection, token precedence, source installation and authentication troubleshooting.

What is available?

Area Start here
Python account/device client Python API guide
Read-only T2C/T10C/T9C detector status Detector guide
CLI inventory, status and controls Command-line guide
Push notifications Channel-99 migration and lifecycle
Images, finite clips and stream paths Media guide
Home Assistant consumers and known gaps HA integration status
Canonical imports and breaking alias removals Compatibility guide
All guides, technical references and research Documentation index

Device controls and stream support depend on model, firmware, region and account permissions. A command's API success is not proof of physical device action. Decoded samples and offline tests are not proof of live HA/browser playback.

Home Assistant

The cloud client is consumed by HA's EZVIZ integration and the ha-ezviz custom integration; they have separate dependency pins and release cycles. The current ha-ezviz consumer needs channel-99 migration and durable token persistence before push can work with this branch. Polling is independent of push.

The native HA example is an isolated validation integration, not a released replacement for either cloud integration. See HA status for tested boundaries and remaining live acceptance work.

Development and support

Apache-2.0; see LICENSE.

Support the maintainer.

Shared device inventory

For one bounded refresh shared across HA platforms, immutable typed states and per-device freshness, see Device inventory. Existing family loaders remain compatible.

Metadata

Release files for pyezvizapi 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyezvizapi 2.0.0
File Size Uploaded Provenance Actions
pyezvizapi-2.0.0.tar.gz 924.1 kB With provenance Details for pyezvizapi-2.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pyezvizapi 2.0.0
File Interpreter ABI Platform Actions
pyezvizapi-2.0.0-py3-none-any.whl Python 3 none any Details for pyezvizapi-2.0.0-py3-none-any.whl

Total release size: 1.5 MB

Release files / pyezvizapi-2.0.0.tar.gz

Download URL pyezvizapi-2.0.0.tar.gz
Size 924.1 kB
Tags Source
SHA-256 checksum
How to use checksums
0494feeeb80321caa3a3dfffd36968ab0ff7b789579228694fdc6b08fc38bbe7
BLAKE2b-256 checksum
How to use checksums
d18d6df848d336572f8c524c51b05ab99147b3c335b6e8cd552d08b806c18b4d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / pyezvizapi-2.0.0-py3-none-any.whl

Download URL pyezvizapi-2.0.0-py3-none-any.whl
Size 597.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ed7c309a1af18e0cdc3665a87d7a1c30c21581ba80a25115d748f76ed2f349f8
BLAKE2b-256 checksum
How to use checksums
a2ba32d44238dd6a41c4796ffa19a79736008be86dfe5175db3061d1e3aa127d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Security for pyezvizapi 2.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for pyezvizapi-2.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page