Shinobi is an open source cctv solution.
To enable this component, first copy custom_components/shinobi
inside your Home Assistant config directory and add the Shinobi component and platform, for example in configuration.yaml
. See https://shinobi.video/docs/api on how to get your api_key
and group_key
. The ssl
param is optional and defaults to false
. The white- and blacklist is also optional and defaults to all active monitors being considered. Only one filtering method can be applied at the same time. For now, the name assigned in Shinobi is used to filter cams.
…
shinobi:
host: <your-cams_ip or hostname>
api_key: <api_key>
group_key: <group_key>
ssl: false
camera:
- platform: shinobi
whitelist:
- cam0_name
blacklist:
- cam1_name
- cam2_name
…
At the moment, all configured and activated cameras (in state, Record
or Watch-only
, see https://shinobi.video/docs/settings) are fetched and added to Home Assistant as MjpegCamera
. For this to work, the stream type has to be set to mjpeg in shinobi (in the individual camera settings, for all cameras that should be displayed in HA, still preview is working fine anyway if the jpeg API is enabled [default in shinobi])
No additional packages have to be installed.
- figure out which camera platform is working best for this (Shinobi allows to switch between different stream output configs, atm only mjpeg is supported as described above)
- add movement detection as (binary?) sensors
- add ptz control (as switches? I have not yet seen a good solution in HA, anybody who can help please drop some lines)
- …