!Logo

ioBroker.cameras



Tests:: 

IP-Cameras adapter for ioBroker

You can integrate your web/ip cameras into vis and other visualizations.
If you configure a camera with name cam1 it will be available on
web server under http(s)://iobroker-IP:8082/cameras.0/cam1.

Additionally, the image could be requested via a message:
``
sendTo('cameras.0', 'image', {
name: 'cam1',
width: 100, // optional
height: 50, // optional
angle: 90 // optional
noCache: true // optional, if you want to get the image not from cache
}, result => {
const img = 'data:' + result.contentType + ';base64,' + result.data;
console.log('Show image: ' + img);
});
`

The result is always in jpg format.

Supported cameras:
- Reolink E1 Pro via RTSP (important, without Pro it will not work)
- Eufy via eusec adapter
- HiKam of second and third generation via ONVIF (für S6, Q8, A7 2. Generation), A7 Pro, A9
- WIWICam M1 via HiKam adapter
- RTSP Native - if your camera supports RTSP protocol
- Screenshots via HTTP URL - if you can get the snapshot from your camera via URL

$3


This is a normal URL request, where all parameters are in URL. Like http://mycam/snapshot.jpg

$3

This is URL request for image, where all parameters are in URL, but you can provide the credentials for basic authentication. Like http://mycam/snapshot.jpg

$3

If you want to access snapshots on RTSP cameras, you can use ffmpeg. You need to install ffmpeg on your system:
- Windows has precompiled ffmpeg and there is no need to download anything. (Windows version is taken from here: https://www.gyan.dev/ffmpeg/builds/ffmpeg-git-essentials.7z)
- Linux: sudo apt-get install ffmpeg -y

Here is an example of how to add Reolink E1:

!rtsp

How to add a new camera (For developers)

To add a new camera, you must create a Pull Request on GitHub with the following changes:
- Add new file into cameras folder. This is a backend to read the single image from the camera.
- Add GUI file in the src/src/Types/ folder. This is the configuration dialog for the camera
- Add this dialog in src/src/Tabs/Cameras.js file analogical as other cameras are added. Only two lines should be added:
- Import new configuration dialog like import RTSPMyCamConfig from '../Types/RTSPMyCam';
- Extend TYPES structure with the new camera like mycam: { Config: RTSPMyCamConfig, name: 'MyCam' },
The attribute name must be the same as the name of the file in the cameras folder.

Todo

- [ ] Send new subscribe requests for RTSP cameras if the dialog is opened or closed

Changelog

$3

* (bluefox) Updated packages

$3

* (bluefox) Removed withStyles package

$3

* (bluefox) Packages updated
* (bluefox) Allowed selecting another source (with bigger resolution) for URL cameras

$3

* (bluefox) Minimal supported Node.js version is 18
* (bluefox) Corrected widgets

$3

* (bluefox) Changed widget set name
* (bluefox) Added the caching of images with time, size and rotation
* (bluefox) Added timeout for RTSP cameras

$3

* (bluefox) Utilized the new js-controller feature: sendToUI. RTSP Streaming works only with js-controller 5.0.13 or higher
* (bluefox) Implemented a second widget for simple cameras

$3

* (bluefox) Added WiWiCam MW1 and HiKam cameras

$3

* (bluefox) Corrected passwords with exclamation mark

$3

* (bluefox) Added eufy camera

$3

* (bluefox) Added Reolink E1 camera

$3

* (bluefox) Corrected GUI config error

$3

* (bluefox) added RTSP camera
* (bluefox) added cache of snapshots

$3

* (bluefox) GUI updated to MUIv5

$3

* (bluefox) replaced the deprecated package request with axios`

$3

* (bluefox) Preparations for js-controller@4.x are made

$3

* (bluefox) Add a role for states

$3

* (Hirsch-DE) Parameters were applied

$3

* (bluefox) implemented get image by message

$3

* (bluefox) URL and URL with basic authentication were implemented

$3

* (bluefox) initial release

License

MIT License

Copyright (c) 2020-2024 bluefox

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.