homebridge-camera-ui
Advanced tools
homebridge-camera-ui allows you to expose cameras from camera.ui to HomeKit via Homebridge. camera.ui does not need to be installed separately. It is installed right away with homebridge-camera-ui
camera.ui is a NVR like PWA to control your RTSP capable cameras with:
and much more...
Supported Languages:
:de: | :gb: | :netherlands: | :fr: | :thailand: | :es:
Demo: https://streamable.com/3yce42
sudo npm install -g homebridge-camera-ui@latest
camera.ui installs itself in the homebridge directory under /var/lib/homebridge/camera.ui/
The database, recordings and a copy of the camera.ui config.json are stored locally in this folder and are never accessible to others. The settings can be changed directly via the interface or over homebridge-config-ui-x
Once you have installed and configured it you can access the interface via http://localhost:8081.
The default username is master and the default password is master. When you log in for the first time, camera.ui will ask you to change your username and password.
{
...
"platforms": [
{
"platform": "CameraUI",
"name": "CameraUI",
"port": 8081,
"cameras": [ ... ]
}
]
}
For a full config.json, please look at Example Config for more details.
The Dashboard is the main page of the interface and offers a variety of widgets to customize it as you like. The widgets will expand over time. At the moment the following widgets are available for the dashboard: Time, Weather, Uptime, Camera, Notifications, RSS Feed, Status, Charts (CPU Load, CPU Temperature, Memory Load), Shortcuts and Log
Here are all cameras listed by room and show the current snapshot as a cover sheet
If you select a camera you can watch the livestream directly in the browser. With the camera.ui player you can pause the stream, turn audio on/off or reload the stream.
All images or videos recorded by motion are listed here. If AWS Rekognition is used, the label for the recording is also displayed, as well as the date and time. Using the filter function, the recordings can be filtered as desired
All motion events as well as system messages can be viewed here. Each notification has one or more labels to better categorize them. The filter function can also be used to filter the notifications as desired.
Camview displays all camera streams in tiles, hiding everything unnecessary. Camview is great for giving a direct insight into the cameras. Also here the streams can be paused by the camera.ui video player, audio can be switched on/off, streams can be reloaded or viewed in full mode.
All events that occur in the backend can be monitored via the built-in log. In addition, the log can be also be cleared or downloaded here.
Using the built-in editor you can easily edit your config.json. In addition, any errors are immediately displayed and thus avoided to save a faulty config.json
"Utilization" shows you a graphical overview of the system utilization. Here you can see in real time how high the CPU utilization is, how high the CPU temperature is and how much memory is still free.
On the settings page you can make ALL settings regarding your config.json and database. All parameters defined in config.json are directly configurable from this page. If camera.ui runs via "Homebridge" you can also set Homebridge relevant parameters here.
HSV requires a Homebridge version of at least 1.4.0-beta.4 or higher. Otherwise HSV will not be enabled.
When the plugin is used with HSV, all recordings from HomeKit Secure Video are automatically transferred to camera.ui as well and stored for them. All camera.ui features like WebPush, Telegram notifications etc. will still work with HSV.
How to configure cameras for HSV
camera.ui offers a variety of options to detect and process motion.
With this option camera.ui connects to the stream and compares frame by frame if there are changes. The zones and sensitivity can be set in the interface.
If the HTTP server is enabled for motion detection, calling the link can easily trigger motion.
Example:
http://localhost:8123/motion?My+Camera
If you have set up the MQTT client (Settings > System > MQTT), you can set the required parameters such as "Motion Topic", "Message" etc. via the interface (Settings > Cameras > MQTT).
Motion Topic: The MQTT topic to watch for motion alerts. The topic (prefix/suffix) should be unique, it will be used to assign the motion detected message to the desired camera.
Motion Message: The message to watch for to trigger motion alerts.
The message can be a simple "string" (e.g. "ON"/"OFF) or a JSON object. If the MQTT message is a JSON object like:
{
"id": "test",
"event": {
"time": 1234567890,
"state": true,
}
}
Then define the exact parameter under "Motion Message" so that camera.ui can read from it, eg:
"motionMessage": {
"event": {
"state": true
}
}
If the SMTP server is turned on and your camera is able to send an email when motion is detected, you can easily trigger motion through it, eg:
From: My+Camera@camera.ui
To: My+Camera@camera.ui
Please note that the camera.ui SMTP server is set in the camera settings (ip/port).
If your camera is able to upload an image when motion is detected, then you can select the camera.ui FTP server as the destination. Very important here is. The path you enter via the camera's own settings page must be the camera name as defined in config.
Every time the camera tries to connect to the server, the camera.ui detects and takes the entered path to determine the camera.
If HomeKit Secure Video (HSV) is disabled, camera.ui also uses image rekognition with Amazon Web Services to analyse, detect, remember and recognize objects, scenes, and faces in images. You can enable for each camera the image rekogniton and you can even set labels for each camera. For each object, scene, and concept the API returns one or more labels. Each label provides the object name. For example, suppose the input image has a lighthouse, the sea, and a rock. The response includes all three labels, one for each object.
This makes it possible to analyze every movement before this is stored or sent as a notification.
To use image rekognition, you need to set up a AWS account with an IAM user. More Infos: AWS Image Rekognition
camera.ui supports numerous notification options. Each of them can be conveniently set via the interface.
Since push notifications only work conditionally for websites (see PWA), you can easily work around this via third-party providers.
These would be e.g.
Via Telegram, you even have the option to send picture or video along with text messages.
This plugin has been verified to work with the following apps/systems:
The following browsers are supported by this plugin:
MS Internet Explorer (any version) is not supported!
Every camera with an RTSP stream!
See Tested Cameras for more info.
Please check our FAQ before you open an issue.
You can contribute to this homebridge plugin in following ways:
If you have any issues with the plugin then you can run this plugin in debug mode, which will provide some additional information. This might be useful for debugging issues. Just open your config ui and set debug to true!
https://github.com/SeydX/homebridge-camera-ui/wiki/Debug
If you have problems with the interface or found bugs, please post it directly at camera.ui
Before you open a new issue, please read carefully the wiki: https://github.com/seydx/homebridge-camera-ui/wiki
Copyright (c) 2020-2022 seydx
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
v5.0.21 - 2022-04-23
/cameras/:name/feed)npm)"debug" in config.json is deprecated now. Replaced with "logLevel". Log Level: Show only defined log level. (Info = Show informative messages during processing. This is in addition to warnings and errors - Debug: Show everything, including debugging information - Warning: Show only warnings and errors - Error: Show only errors)"hksvConfig" to the camera block next to "videoConfig". Here various parameters are defined for the HKSV recording process only, such as a different source, vcodec, acodec, etc."disable" parameter to the camera block. The parameter disables the camera and removes it from HomeKit.Settings > Cameras > Notifications > MQTT Publish Topicffmpeg-for-homebridgeFAQs
User Interface for RTSP capable cameras with HSV support.
The npm package homebridge-camera-ui receives a total of 172 weekly downloads. As such, homebridge-camera-ui popularity was classified as not popular.
We found that homebridge-camera-ui demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket researchers have discovered malicious npm packages targeting crypto developers, stealing credentials and wallet data using spyware delivered through typosquats of popular cryptographic libraries.
Security News
Socket's package search now displays weekly downloads for npm packages, helping developers quickly assess popularity and make more informed decisions.
Security News
A Stanford study reveals 9.5% of engineers contribute almost nothing, costing tech $90B annually, with remote work fueling the rise of "ghost engineers."