---
title: "XMeye / Xiongmai NVR"
description: "XMeye / Xiongmai NVR is a Marketplace integration for Home Assistant. It has 54 installs sharing analytics, works locally and was last updated October 19, 2026."
canonical: "https://vulpo.app/integrations/marketplace/moxnatiy-hass-xmeye"
url: "https://vulpo.app/integrations/marketplace/moxnatiy-hass-xmeye.md"
last-updated: "2026-10-23"
version: "1.4"
---

# XMeye / Xiongmai NVR

> XMeye / Xiongmai NVR is a Marketplace integration for Home Assistant. It has 54 installs sharing analytics, works locally and was last updated October 19, 2026.

XMeye / Xiongmai NVR connects Home Assistant to Xiongmai-based recorders over the local DVRIP protocol. It talks to the recorder directly, so no cloud account or ONVIF is needed. It adds a sidebar panel with a live video wall, a low-latency WebCodecs player and an archive timeline for playback. Entities cover cameras, recording and motion sensors, disk and bitrate readings, detection switches, and buttons to reboot the recorder or sync its time. Actions allow PTZ control, searching and downloading recordings, reading and writing recorder configuration, and sending audio to its speaker. Setup is done in the UI with the recorder's address, user and password.

Automatic summary of the README and code of Moxnatiy/hass-xmeye. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=Moxnatiy&repository=hass-xmeye&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=Moxnatiy&repository=hass-xmeye&category=integration)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

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

### XMeye / Xiongmai NVR

- **Host**
- **Username**
- **Password**
- **DVRIP port**
- **RTSP port**

### Password changed

- **Password**

### After setup

- **Channels to expose**
- **Camera stream**: The sub stream is far lighter to transcode; the main stream is 4K.
- **Snapshot stream**
- **Panel player**: Which player the panel opens with. Native (WebCodecs) has the lowest latency.
- **Panel live stream**
- **Update interval**
- **Max device connections (TCPMaxConn)**: Written to the recorder. It caps how many streams run at once; raising it above 10 is not honoured by every firmware.
- **Use RTSP for live video**: Turn off only if RTSP is disabled on the recorder.
- **Show the XMeye sidebar panel**

Texts from the code of [Moxnatiy/hass-xmeye](https://github.com/Moxnatiy/hass-xmeye).

## Entities

- **Binary sensors**: Recording, Motion, Disk problem, Alarm input, Connected, Video loss, Camera blinded
- **Buttons**: Reboot, Sync time
- **Sensors**: Uptime, Total bitrate, Channels online, Recording channels, Disk used, Disk free, Archive starts, Archive ends, Recorder time, Bitrate
- **Switches**: Motion detection, Blind detection, Video loss detection

## Actions

- **PTZ control**: Move a PTZ camera or jump to a preset.
  Fields: Recorder, Direction, Channel, Speed, Duration, Preset
- **Search recordings**: List archive recordings for a channel and time range.
  Fields: Recorder, Channel, Start, End, Event
- **Download recording**: Download a recording into the media folder as an elementary stream.
  Fields: Recorder, File name, Start, End, Channel
- **Read configuration**: Read one configuration section from the recorder.
  Fields: Recorder, Section
- **Write configuration**: Write one configuration section back to the recorder.
  Fields: Recorder, Section, Value
- **Play audio**: Send G.711 audio to the recorder's speaker.
  Fields: Recorder, Audio file

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.

## From the README

> A local integration for recorders running Xiongmai firmware —
>
> a live video wall, a scrubbable archive and the recorder's own settings,
>
> - A video wall that holds up. Every tile travels on one WebSocket, so a wall of sixteen cameras does not run into the browser's six-connections-per-host limit. Tiles are added, removed, reordered and…
> - About a second of latency. Frames go from the recorder straight into the browser's hardware decoder through WebCodecs — no segmenting, no repackaging, and no work for Home Assistant beyond moving…
> - An archive you can actually aim at. A day's recordings on a timeline that zooms down to a minute with the scroll wheel or a pinch. A click starts playback at that exact second, ×1 to ×8, and the…
> - The recorder's settings, as a form. Motion, blind and video-loss detection per channel, overlays, disks, network time and more — typed fields instead of raw JSON, and the whole configuration tree…
> - Five languages. English, Ukrainian, Spanish, French and German, following Home Assistant's language setting.
> - Pan, tilt and zoom on the wall. Point at a tile and a pad appears: hold an arrow to turn, click for a short step, and keep up to eight presets. A camera stops by itself if the browser goes quiet…
> - Sound. A speaker on each tile and in the single-camera view plays the camera's microphone, decoded in the browser.

From the README of [Moxnatiy/hass-xmeye](https://github.com/Moxnatiy/hass-xmeye#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Security and safety](https://vulpo.app/integrations/category/security-and-safety.md), Cameras
- Number: 54 installs sharing analytics; 8 GitHub stars
- Connection: Works locally
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v0.8.1, last updated October 19, 2026
- Domain: `xmeye`
- Source: <https://github.com/Moxnatiy/hass-xmeye>
- Issues: <https://github.com/Moxnatiy/hass-xmeye/issues>
- Screenshot: https://vulpo.app/integrations-img/c707a58a8798fb95.webp (from Moxnatiy/hass-xmeye's README)
- Screenshot: https://vulpo.app/integrations-img/6919a6e7c3b38dc8.webp (from Moxnatiy/hass-xmeye's README)
- Screenshot: https://vulpo.app/integrations-img/136a53c601d1185e.webp (from Moxnatiy/hass-xmeye's README)

In Vulpo: Quick Toggle card, Camera card, Button card, Chart card, Apple Watch, Control Center

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-23. Source: https://vulpo.app/integrations/marketplace/moxnatiy-hass-xmeye

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/moxnatiy-hass-xmeye
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml
