Home Assistant integration for ICSee/XMEye/DVR-IP/NetSurveillance/Sofia cameras.
- Live video (main and sub stream), played by Home Assistant's built-in go2rtc
- Motion alarm
- PTZ: move, zoom, presets
- Camera settings as entities: infrared / day-night mode, white light, frame rate, resolution, quality, image flip and colors, motion detection and tracking, volume, status LED, privacy mode and more
- Camera speaker as a media player (e.g. for text-to-speech)
- Security: cloud (P2P) access and status, cloud push, password reset options, camera accounts
- Finds cameras on your network by itself
Each camera only gets the entities it supports. Requires Home Assistant 2025.10 or newer.
Option 1: HACS Link
Option 2: HACS
- Or
HACS>Integrations>⋮>Custom Repositories Repository: paste the url of this repoCategory: Integration- Click
Add - Close
Custom Repositoriesmodal - Click
+ EXPLORE & DOWNLOAD REPOSITORIES - Search for
icsee - Click
Download - Restart Home Assistant
- Copy the
icsee_ptzfolder insidecustom_componentsof this repo to/config/custom_componentsin your Home Assistant instance - Restart Home Assistant
Cameras on your network are found automatically and show up under
Settings -> Devices & services -> Discovered. You can also add one by hand.
You only need the camera password (the one set in the ICSee/XMEye app).
The port is usually 34567. Only change it if your camera uses a different one (e.g. behind port forwarding).
This integration creates a device per camera with a motion alarm, camera entities,
PTZ buttons, settings, and the icsee_ptz.move action for PTZ.
Motion or human detection must be enabled on the camera. You can do that with the detection switches of this integration. Then, you can use the motion alarm entity in your automations.
icsee_ptz.move: move, zoom and set/goto preseets.
alias: Notify camera motion alarm
description: ""
trigger:
- platform: state
entity_id:
- binary_sensor.garden_motion_alarm
to: "on"
condition: []
action:
- service: notify.mobile_app_pixel_7
data:
message: TTS
data:
tts_text: Attention: motion detected in garden
ttl: 0
priority: high
mode: single
Usage in WebRTC card:
# lovelace card
type: custom:webrtc-camera
url: garden_dvrip
ui: true
shortcuts:
services:
- name: Sync
icon: mdi:clock-check
service: icsee_ptz.synchronize_clock
service_data:
entity_id: binary_sensor.garten_motion_alarm
- name: Force frame
icon: mdi:play
service: icsee_ptz.force_frame
service_data:
entity_id: binary_sensor.garten_motion_alarm
ptz:
service: icsee_ptz.move
data_home:
entity_id: binary_sensor.garten_motion_alarm
cmd: GotoPreset
preset: 0
data_long_home:
entity_id: binary_sensor.garten_motion_alarm
cmd: SetPreset
preset: 0
data_left_start:
entity_id: binary_sensor.garten_motion_alarm
cmd: DirectionLeft
data_left_end:
entity_id: binary_sensor.garten_motion_alarm
cmd: Stop
data_right_start:
entity_id: binary_sensor.garten_motion_alarm
cmd: DirectionRight
data_right_end:
entity_id: binary_sensor.garten_motion_alarm
cmd: Stop
data_down_start:
entity_id: binary_sensor.garten_motion_alarm
cmd: DirectionDown
data_down_end:
entity_id: binary_sensor.garten_motion_alarm
cmd: Stop
data_up_start:
entity_id: binary_sensor.garten_motion_alarm
cmd: DirectionUp
data_up_end:
entity_id: binary_sensor.garten_motion_alarm
cmd: Stop
Each camera gets a camera.*_main_stream and a camera.*_sub_stream entity. Home Assistant
plays them through its built-in go2rtc; you don't need to configure go2rtc.
Snapshots come from the stream too.
The video comes from the camera's RTSP server (Home Assistant's built-in go2rtc has no DVRIP support). If it is off, a repair message tells you to turn on the camera's RTSP server switch.
Some cameras have no RTSP server at all (no RTSP server switch). Their streams use DVRIP,
which needs a full go2rtc: the go2rtc add-on, or WebRTC Camera
from HACS. Point Home Assistant to it with go2rtc: url: http://<go2rtc host>:1984 in
configuration.yaml. Some recent firmware only answers encrypted DVRIP, which go2rtc can't play
yet (#77).
If you prefer your own go2rtc, these streams work there as well:
# go2rtc.yaml
streams:
garden_dvrip:
- dvrip://admin:my_password@192.168.178.104:34567
garden_dvrip_mini:
- dvrip://admin:my_password@192.168.178.104:34567?channel=0&subtype=1
garden: # try this if the video is choppy or audio is out of synch
- ffmpeg:garden_dvrip#audio=copy#async#video=copy#asyncEntities only appear if the camera supports them.
| Entity | Type | What it does |
|---|---|---|
| Alarm and video | ||
| Motion alarm | binary_sensor | On while the camera reports an alarm. Motion or human detection must be enabled on the camera, e.g. with the detection switches below. Also the target of the icsee_ptz.move action. Alarms shorter than the minimum motion time option (default 150 ms) are ignored, and the motion stick time option (default 0) keeps it on after the alarm stops. |
| Main stream / Sub stream | camera | Live video in high / low quality. Played by Home Assistant's go2rtc; snapshots come from the stream. Needs the RTSP server switch on. |
| PTZ | ||
| PTZ up / down / left / right / stop | button | Move the camera. Speed = the Step option. |
| PTZ diagonal moves, zoom in / out | button | Move diagonally, zoom. |
| PTZ home go to / PTZ home set current position | button | Go to / save the preset from the options (default 0). |
| PTZ home clear | button | Delete that preset. |
| PTZ go to preset | select | Move to one of the positions saved on the camera. |
| Restart returns to last position | switch | After a restart the camera moves back to where it was. |
| Lights and night vision | ||
| Day/night mode | select | When the camera uses infrared (IR). Auto: IR at night. Always color: IR never turns on (dark at night). Always black & white: IR always on. Cameras with a white light also offer white light on motion, full color at night and auto, infrared light; on these, Starlight infrared replaces Auto and does not turn on the IR light. |
| White light | switch | Turn the white light on / off by hand (sets the white light mode to Always on / Off). |
| White light mode | select | Off, Always on, Auto (at night), Schedule, On motion. On IR + white light cameras this is also the night vision mode: Auto = full color, Off = infrared. |
| White light brightness / motion duration / motion sensitivity | number/select | Brightness, and how long and how easily the light turns on in On motion mode. |
| Day/night switch sensitivity | number | 0-10. How early the camera switches to night mode. |
| Day/night switch | select | Force day or night mode, switch automatically, or use a schedule. |
| Night vision | switch | Main switch for the night lights (IR and white light). |
| Night vision enhancement | switch | Brighter night image. |
| Low light fill | switch | The app's "low light control": use the fill light in low light. |
| Light sensor threshold | number | 1-5. How dark it must get before the night lights turn on. |
| Starlight mode | switch | Brighter image in very low light: the sensor boosts its signal and exposes each frame longer. Keeps color longer, but adds grain, blurs movement and can lower the real frame rate. |
| IR filter reversed | switch | For cameras whose day/night filter works the wrong way round (pink image by day, grey by night). |
| Video settings (main and sub stream) | ||
| Resolution | select | Picture size, e.g. 1080P, 3M, 4M. |
| Frame rate | number | The maximum follows the camera's encoding limit and the video standard (25 PAL / 30 NTSC). |
| Quality | select | Bad ... Best. Higher = better picture, more data. |
| Codec | select | H.264 / H.265. H.265 uses less data but not every player supports it. |
| Main stream smart encoding | select | Main stream: H.264, H.264+ or H.265X (smarter compression, less data). |
| Video standard | sensor | PAL (up to 25 fps) or NTSC (up to 30 fps). |
| Bitrate | number | Target data rate in kbit/s. |
| Bitrate control | select | Constant (steady data rate) or Variable (more data for busy scenes). |
| Key frame interval | number | Seconds between full frames. Lower = faster video start, more data. |
| Sub stream, main / sub stream audio | switch | Turn the sub stream or the audio in a stream off. |
| Image | ||
| Image flip / Image mirror | switch | For cameras mounted upside down or reversed. |
| Video time / name / logo shown | switch | Text and logo burned into the video. |
| Video time position / Video name position | select | The corner of the picture where the time / camera name is shown. |
| Video name text | text | The camera name shown on the video (see Video name shown). |
| Image brightness / contrast / saturation / hue | number | Picture colors, 0-100 (default 50). |
| Image style | select | Three color and sharpness presets of the camera. |
| Image anti-flicker | switch | Removes flicker from lamps on 50/60 Hz power. |
| Image corridor mode | select | Turns the image to portrait, for long narrow views like hallways. |
| Image noise reduction (day / night) | number | 0 = off, 1-5 = stronger filtering. More filtering gives a cleaner night image and fewer false motion alarms, but less detail. |
| Gain (automatic) / Gain | switch/number | With automatic gain on, Gain is the maximum amplification; with it off, a fixed amplification. Less gain means less noise but a darker image. |
| Exposure sensitivity | number | How quickly the exposure reacts. The range is a best guess. |
| Exposure metering | select | Measure the brightness over the whole image or only the center. |
| Image stabilization / Image lens distortion correction | switch | Electronic stabilization; straightens the curved edges of wide lenses. |
| Wide dynamic range level | number | Strength of wide dynamic range (see the WDR switch). |
| IR filter switching | select | Whether the IR filter switches together with the IR light, or by itself. |
| Exposure time | sensor | The exposure time the camera uses right now. |
| Exposure time (maximum) | number | The longest exposure the camera uses in the dark. Shorter gives less motion blur, but a darker and noisier image. |
| Anti-fog / Anti-fog level | switch/number | Adds contrast to hazy or foggy images. |
| Wide dynamic range | switch | Shows detail in bright and dark parts at the same time, e.g. a door with sunlight behind it. |
| Prevent overexposure | switch | Stops close, bright objects (e.g. a face lit by IR) from turning white. |
| Detection | ||
| Motion detection / Human detection | switch | Turn the camera's detection on / off. These trigger the motion alarm. |
| Motion sensitivity | number | 1 (low) - 6 (high). |
| Motion tracking, tracking sensitivity, tracking return time | switch/select/number | The camera turns to follow moving people, and returns to its start position after the set time. |
| Tamper detection / Video loss detection | switch | Alarm when the camera is covered / loses video. |
| Tamper detection sensitivity | number | 1 (low) - 6 (high). |
| Human detection sensitivity / Human detection box | select/switch | How easily people are detected / draw a box around them in the video. |
| Human detection targets | select | Detect people, vehicles or both. Only on cameras that can detect vehicles. |
| Motion push notification / record / snapshot / beep | switch | What the camera itself does when it detects motion. |
| Motion warning light / Motion warning light duration | switch/number | Turn on the camera's light when it detects motion, and for how long. |
| Motion recording duration | number | How long the camera records after motion (needs an SD card). |
| Motion alarm hold time | number | How long an alarm stays active after the last motion. |
| Motion PIR sensitivity | number | For cameras with a PIR (body heat) sensor. |
| SD card recording / pre-recording / file length | select/number | Record always, by the schedule set in the app, or never; seconds kept from before an event; minutes per video file. |
| Audio | ||
| Speaker | media_player | Play text-to-speech, sounds or internet radio (also .m3u / .pls playlists) on the camera speaker. |
| Speaker volume | number | Volume of the camera speaker (TTS, voice prompts, alarm sounds). |
| Microphone volume | number | Sensitivity of the camera microphone (the sound in the video). |
| Other | ||
| Status LED / Voice prompts | switch | The LED and the spoken messages of the camera ("device connected", ...). |
| Privacy mode | switch | Blacks out the video. |
| Sleep schedule | switch | The camera's own sleep schedule (set times in the app). |
| Restart / Clock synchronize | button | Restart the camera / set its clock to the Home Assistant time. |
| Restart automatically / Restart automatically hour | select/number | Weekly or daily restart of the camera. |
| Restart when network is lost | switch | The camera restarts itself when the network is gone for a while. |
| Clock internet time (NTP) | switch | The camera sets its own clock from the internet. |
| Clock time format / Clock date format | select | How the time and date are shown on the video. |
| Clock daylight saving time | switch | The camera changes its clock by one hour. Turning it on uses the dates of the Home Assistant time zone. |
| Restarts (abnormal) | sensor | How often the camera restarted because its video stopped. |
| Restarts (network loss) | sensor | How often the camera restarted because the network was lost. |
| Siren | siren | The camera's built-in alarm siren. |
| Security | ||
| RTSP server | switch | The camera's RTSP video server (port 554). Needed for the camera entities. |
| Cloud access (P2P) | switch | The XMEye/ICSee cloud connection that lets the apps reach the camera from anywhere. Turn it off if you only use it at home. |
| Cloud push notifications | switch | Alarm messages to the phone app. |
| Cloud push notification interval | number | The minimum time between two alarm messages to the phone app. |
| Cloud block all servers / Cloud block P2P, relay, streaming server | switch | Cut the camera off from the Xiongmai cloud servers (all, or one kind). The apps then only work at home. |
| Cloud access server (DAS) | switch | Another cloud connection. |
| ONVIF password required | switch | Whether NVRs and other ONVIF clients must log in with the password. May need a camera restart. |
| UPnP port forwarding | switch | Lets the camera open ports on your router by itself. Usually best off. |
| UPnP router ports open | binary_sensor | On if UPnP has opened ports on your router. |
| Firmware updates online / Firmware updates install automatically | switch | Firmware updates from the cloud. New firmware can block this integration (see issue #65), so consider turning automatic installs off. |
| Telnet debug access | binary_sensor | On if a debug login (telnet) is open on the camera. |
| Linked to app account | binary_sensor | On if the camera is linked to an ICSee/XMEye account. |
| Password reset by security questions / email or phone set | binary_sensor | On if someone can reset the camera password with security answers / a code sent by email or phone. |
| Password reset by code | switch | Allow resetting the camera password with a code from the app (QR code). |
| Users / Logged in as | sensor | Number of camera accounts (names and groups in the users attribute) / the account this integration uses. |
| Cloud status | sensor | Whether the camera is connected to the XMEye/ICSee cloud right now. |
| WiFi signal / SD card size / SD card free | sensor | WiFi strength; SD card sensors only appear when a card is inserted. |
The frame rate and resolution are checked against the camera's encoding limit before they are saved.
Some recent firmware versions only answer to the "encrypted" transport that the official apps use (older clients log in but get empty replies). This integration detects that during login and switches to it automatically, so those cameras work too. Cameras that use the plain protocol are unaffected. This uses a fixed key shipped in the apps for interoperability; it does not change or bypass your camera password.
- Cloud access (P2P): the XMEye/ICSee cloud connection that lets the apps reach the camera from anywhere. Turn it off if you only use the camera at home.
- Password reset: the apps can reset the camera password with security questions, a code sent by email/phone, or (on some cameras) a code. The indicators show if questions or an email/phone are set.
- Cloud status shows if the camera is connected to the cloud right now.
- Entity IDs stay the same.
- The "experimental entities" option is gone: all supported entities are created.
- The options of the day/night and white light selects changed names (e.g.
KeepOpen->keep_open). Update automations that useselect.select_optionwith the old names. - The
move,synchronize_clockandforce_frameactions still target the motion alarm entity.
Frame rate and encoding can now be set from Home Assistant. The Windows app https://xmeye.org/xmeye-for-pc/ can still change settings this integration does not cover.
in device config / encode config select:
- fps: 30 (maximum available)
- Iframe interval: 1 (minimum available)
- Static encode config: high profile
- H264+ enable: disabled
in device config / camera param select:
- Clear fog: ON
- Level: 100
