Person detection for every camera in Home Assistant
Litmus NVR runs AI detection on your own computer and gives each camera a Home Assistant device with person, vehicle, animal and sound sensors. You connect it from the Home Assistant integrations screen, with no YAML.
What each camera gets
| Entity | What it does |
|---|---|
| Camera | Live video and snapshots |
| Person, Vehicle, Animal, Sound | Turn on when detected and off 30 seconds after the last detection |
| All | On while any of the detections you turned on is present |
| Person, Vehicle and Animal count | How many are in the picture right now |
| Recognized face, Recognized plate | The name of the last recognized registered face and the last license plate, cleared after 60 seconds |
| Alert | An event each time an action runs, with its title, message, image and recording |
| Last alert | The image of the last alert |
| Detect, Record | Switches that turn detection and recording off and on for the camera |
If you draw detection zones on a camera, each zone becomes a device with its own person, vehicle, animal and all sensors and counts.
Connect it
- Install Litmus NVR on a Windows, Mac or Linux computer, in Docker, or as a Home Assistant add-on, and connect your cameras. Home Assistant 2025.1 or later must be on the same network.
- In Litmus, open Settings > Integrations and turn on Home Assistant.
- In Home Assistant, open Settings > Marketplace, choose Add from link and enter https://github.com/grablo/litmus-hass-integration, then install Litmus NVR. On Home Assistant 2026.10 or earlier, add the same address in HACS as a custom repository.
- In Settings > Devices & services, add Litmus NVR (it may already be listed as discovered) and sign in with your Litmus local account. Home Assistant does not store the password.
Example: turn on the porch light when a person comes at night
Trigger an automation when the front door camera’s Person sensor turns on, add a condition for the time after sunset, and turn on the light. The sensor turns off 30 seconds after the person leaves, so you can turn the light off with a second trigger.
Alerts on your phone with the picture
The integration includes a blueprint that sends Litmus alerts to the Home Assistant phone app. The notification shows the action’s title, message and the image of that moment, and tapping it plays the recording of that event.
Recordings in Home Assistant
In Home Assistant’s Media, choose Litmus NVR to see folders for people, faces, vehicles and animals and a folder for each camera. The people, faces, vehicles and animals folders show the last 7 days by date.
What Litmus does
- Every person and vehicle becomes a card. Litmus detects people and vehicles as it records and turns each one into a card, so you browse who was there instead of scrubbing a timeline.
- Follow someone across cameras. Open a card to see that person’s stays on each camera in time order, and play any of them.
- Four ways to search. By appearance (clothing and build), by face with no enrollment, by a description such as “a person in a yellow shirt”, or by attributes like clothing color, bag, hat and age group. Vehicles can be searched by license plate, and a partial plate works.
- Works locally, no sign-up. On your network, open it in a browser without a Litmus account.
- Remote viewing without port forwarding. Add the device to your Litmus account, and the phone app and browser connect over an encrypted peer-to-peer connection, which works on most home and office routers.
- Video stays on your hardware. Recordings and analysis are stored on the computer running Litmus, not in the cloud.
Questions
Does my video go through the internet?
No. Home Assistant connects directly to the device on the same network. Video and detections do not go through the Litmus servers.
Can I talk through the camera from Home Assistant?
Yes, on cameras that support talking, with Home Assistant 2026.11 or later. Turn on Two-way audio in Settings > System > Labs first; it is an experimental Home Assistant feature.
What hardware does Litmus need?
An Intel N100 mini PC handles 1 to 2 cameras, a 12th-gen Core i5 5 to 6, a 12th-gen Core i7 9 to 10, and an Apple M2 Mac 12 to 14. A Raspberry Pi 5 handles 1 to 2. A graphics card lets the same PC handle more cameras. These are for 1080p cameras at the default 10 analyses per second. The Apple M2 count is measured. The PC counts are estimates based on CPU performance.
Is Litmus NVR really free?
Yes. Every feature is free with no camera limit. Live View over a direct connection is unlimited on every plan. Paid plans only add relay server bandwidth for networks that block direct connections, and more cloud storage for alert photos.