Create eufy camera integration #158730
Open
Create eufy camera integration #158730
+6,316
−0
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
ptarjan
pushed a commit
to ptarjan/home-assistant.io
that referenced
this pull request
Dec 11, 2025
Add documentation for the new Eufy Security camera integration which allows users to view and stream their Eufy Security cameras in Home Assistant. Supports config flow setup, RTSP local streaming with cloud fallback, and snapshot support. For home-assistant/core#158730
ptarjan
pushed a commit
to ptarjan/home-assistant.io
that referenced
this pull request
Dec 11, 2025
Add documentation for the new Eufy Security camera integration which allows users to view and stream their Eufy Security cameras in Home Assistant. Supports config flow setup, RTSP local streaming with cloud fallback, and snapshot support. For home-assistant/core#158730
ptarjan
added a commit
to ptarjan/home-assistant.io
that referenced
this pull request
Dec 11, 2025
Add documentation for the new Eufy Security camera integration which allows users to view and stream their Eufy Security cameras in Home Assistant. Supports config flow setup, RTSP local streaming with cloud fallback, and snapshot support. For home-assistant/core#158730
8 tasks
ptarjan
added a commit
to ptarjan/home-assistant.io
that referenced
this pull request
Dec 11, 2025
Add documentation for the new Eufy Security camera integration which allows users to view and stream their Eufy Security cameras in Home Assistant. Supports config flow setup, RTSP local streaming with cloud fallback, and snapshot support. For home-assistant/core#158730
ptarjan
force-pushed
the
claude/eufy-cameras-integration-01Fs8qN19PcAcJarnqDUrT7y
branch
from
370f225 to
fa76f0f
Compare
pantherale0
suggested changes
Dec 12, 2025
![home-assistant[bot]](https://avatars.githubusercontent.com/in/97978?s=60&v=4){kind=small}
|
Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍 |
ptarjan
force-pushed
the
claude/eufy-cameras-integration-01Fs8qN19PcAcJarnqDUrT7y
branch
from
24175b8 to
51e7643
Compare
ptarjan
force-pushed
the
claude/eufy-cameras-integration-01Fs8qN19PcAcJarnqDUrT7y
branch
from
d0b5f4c to
7355417
Compare
Changed the integration to connect to the eufy-security-ws WebSocket add-on instead of directly calling the Eufy API. This follows the same approach used by the popular HACS integration. Key changes: - New WebSocket API client that communicates with eufy-security-ws - Config flow now asks for host/port instead of email/password - Integration connects to the add-on which handles Eufy authentication - Supports both RTSP and P2P livestreaming through the add-on - Removed direct API authentication (handled by add-on) The eufy-security-ws add-on must be installed separately from: https://github.com/bropat/hassio-eufy-security-ws
Reverted to the direct Eufy Security cloud API approach instead of requiring the eufy-security-ws add-on. Key changes: - Uses email/password login directly with Eufy's cloud API - Password is MD5 hashed as expected by the API - User-Agent mimics the mobile app to reduce blocking - Supports reauth flow for credential updates - Includes proper error handling for API blocks Note: Eufy may still block some API requests. If you experience connection issues, you may need to use the eufy-security-ws add-on from HACS instead.
Inlined and adapted the python-eufy-security library (by keshavdv/FuzzyMistborn) directly into the integration. This provides: - Token expiration tracking with automatic refresh - Domain switching when Eufy returns an alternative API endpoint - Retry logic on 401 errors (re-authenticates automatically) - Error code mapping (e.g., 26006 = InvalidCredentialsError) - Camera dataclass with properties from camera_info dict - Cleaner request handling with skip_auth option This approach maintains the library ourselves rather than depending on an archived external package.
- Add 60-second throttling for RTSP snapshot captures to prevent overwhelming cameras with connections - Add asyncio.Lock() to prevent concurrent snapshot captures - Add ffmpeg timeout and process cleanup on timeout - Fix lint issues: import ordering, type annotations, logger messages - Move inline imports to top-level for ruff PLC0415 compliance - Use contextlib.suppress for cleaner exception handling 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Set _attr_name = None for main camera entity (use device name only) - Add attribute constants (ATTR_*) for state attributes - Prefer local RTSP streaming over cloud when credentials configured - Remove duplicate RTSP constant definitions from config_flow - Remove unused camera entity translation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Fix conftest.py to mock EufySecurityAPI class instead of non-existent async_login function in __init__ - Add separate mock_config_flow_api fixture for config flow tests - Update test_config_flow.py to use real exception classes from api module - Update test_init.py to mock EufySecurityAPI properly - Fix test_camera.py entity_id (now camera.front_door_camera without suffix since _attr_name = None) - Add ip_address and rtsp_credentials to mock_camera fixture - Update mock_config_entry to include all required data fields 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add @ptarjan as codeowner in manifest.json - Add data_description for CAPTCHA steps in strings.json - Expand test_config_flow.py with CAPTCHA, reauth, and options flow tests - Expand test_camera.py with streaming, snapshot, and cleanup tests - Expand test_init.py with session restoration and error handling tests 54 tests passing, covering: - __init__.py: 100% - config_flow.py: 90% - camera.py: 89% - coordinator.py: 87% 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add CaptchaRequiredError handling to coordinator to trigger reauth flow when CAPTCHA is required during data refresh - Remove unused refresh_after decorator from entity.py - Update quality_scale.yaml to mark completed items: - config-flow-test-coverage: done - integration-owner: done - test-coverage: done 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
New integrations require Bronze tier which mandates documentation. Marking docs as done - documentation PR to be submitted to home-assistant.io repository. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add log-when-unavailable: Log once when API becomes unavailable, log again when connection is restored - Add missing Silver quality scale rules (action-exceptions exempt, docs-configuration-parameters, docs-installation-parameters) - Update manifest to quality_scale: silver 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add test_coordinator.py with error handling and recovery logging tests - Add camera tests for exception_wrap decorator, snapshot lock, and ffmpeg errors - Add config_flow tests for CAPTCHA step error handling paths - Achieve 100% coverage on coordinator.py, entity.py, camera.py, config_flow.py 73 tests passing with full coverage on all integration files. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add diagnostics module for debug data collection with sensitive data redaction - Add reconfigure flow for updating credentials without removing device - Add dynamic device detection when coordinator detects new cameras - Add stale device removal support via async_remove_config_entry_device - Add comprehensive API tests (37 new tests) improving coverage from 25% to 56% - Update quality_scale.yaml with Gold rule status 128 tests passing, 84% overall coverage 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add 70 tests covering EufySecurityAPI, Camera, Station classes - Test authentication flows: success, CAPTCHA, invalid credentials - Test crypto state save/restore for session persistence - Test async_request with token expiration, 401 retry, custom headers - Test async_update_device_info with encrypted/unencrypted responses - Test async_get_latest_events with various response formats - Test async_login helper function - Test edge cases: encrypted null/dict/string responses, missing device_sn Coverage improved from 25% to 99% for api.py Total integration coverage: 99% (161 tests) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add eufy_security to strict typing in .strict-typing - Fix positional-only parameter in entity.py exception wrapper - Use typed EufySecurityConfigEntry in config_flow.py - Update manifest.json quality_scale to platinum - Mark all quality scale rules as done/exempt - Add mypy.ini configuration for eufy_security Platinum requirements met: - async-dependency: Uses aiohttp (async) - inject-websession: Uses async_get_clientsession - strict-typing: Full type hints with mypy --strict passing 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Cast dict.get() return values to str to satisfy strict mypy checking for return type annotations. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
ptarjan
force-pushed
the
claude/eufy-cameras-integration-01Fs8qN19PcAcJarnqDUrT7y
branch
from
1c42a2d to
a6bf910
Compare
ptarjan
force-pushed
the
claude/eufy-cameras-integration-01Fs8qN19PcAcJarnqDUrT7y
branch
from
a438ead to
ee54cd0
Compare
ptarjan
force-pushed
the
claude/eufy-cameras-integration-01Fs8qN19PcAcJarnqDUrT7y
branch
2 times, most recently
from
73ef25d to
e5f0950
Compare
- Extract API client to separate pyeufysecurity package - Update manifest.json to use pyeufysecurity==0.4.3 - Update tests to use external package imports - Fix API constructor parameter order and method names 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
ptarjan
force-pushed
the
claude/eufy-cameras-integration-01Fs8qN19PcAcJarnqDUrT7y
branch
from
e5f0950 to
789939b
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Add a new Eufy Security integration that allows users to view and stream their Eufy Security cameras in Home Assistant. This is basically a glorified RTSP viewer when you don't have their cloud service but it felt useful enough to have the discovery for me.
Docs PR: home-assistant/home-assistant.io#42523
Breaking change
Proposed change
Type of change
Additional information
Checklist
ruff format homeassistant tests)If user exposed functionality or configuration variables are added/changed:
If the code communicates with devices, web services, or third-party tools:
Updated and included derived files by running:
python3 -m script.hassfest.requirements_all.txt.Updated by running
python3 -m script.gen_requirements_all.To help with the load of incoming pull requests: