Cameras Config

Cameras

Example:

"cameras": [
  {
    "name": "Living Room Camera",
    "useInterfaceTimer": true,
    "motionTimeout": 15,
    "recordOnMovement": true,
    "prebuffering": true,
    "forcePrebuffering": false,
    "prebufferLength": 8,
    "videoConfig": {
      "source": "-i rtsp://192.168.123.1/stream",
      "subSource": "-i rtsp://192.168.123.1/lowres/stream",
      "stillImageSource": "-i rtsp://192.168.123.1/image.jpg",
      "rtspTransport": "tcp",
      "maxStreams": 4,
      "maxWidth": 1280,
      "maxHeight": 720,
      "maxFPS": 20,
      "maxBitrate": 199,
      "forceMax": true,
      "vcodec": "copy",
      "acodec": "libfdk_aac",
      "audio": true,
      "debug": true
    }
  }
]

Info

Attributes	Required	Usage	Default	Options
name	X	Set the camera name for display in the Home app.
motionTimeout		The number of seconds after triggering to reset the motion sensor. Set to 0 to disable resetting of motion trigger for MQTT or HTTP.	15	15 - 180
useInterfaceTimer		If enabled, the recording timer from camera.ui will be used for "motionTimeout".	false	true/false
prebuffering		Enables camera video prebuffering.	false	true/false
forcePrebuffering		For cameras without a H264 stream. If set, camera.ui will start prebuffering with reencoding the stream. Caution: This will lead to a higher CPU load!	false	true/false
prebufferLength		EThe length of the requested prebuffered video (s)	4	4 - 8

Info (videoConfig)

Attributes	Required	Usage	Default	Options
source	x	FFmpeg options on where to find and how to decode your camera's video stream. The most basic form is -i followed by your camera's URL.
subSource		Low Resolution Substream. FFmpeg options on where to find and how to decode your camera's video substream. The most basic form is '-i' followed by your camera's URL. The substream will be used to probe the stream or for motion detection through video analysis.
stillImageSource		If your camera also provides a URL for a still image, that can be defined here with the same syntax as source. If not set, the plugin will grab one frame from source.
vcodec		Set the codec used for encoding video, must be H.264-based. You can change to a hardware accelerated video codec with this option, if one is available.	libx264
audio		Enables audio streaming from camera.	false	true/false
packetSize		If audio or video is choppy try a smaller value, should be set to a multiple of 188.	1316
mapvideo		Selects the stream used for video.	FFmpeg automatically selects a video stream
mapaudio		Selects the stream used for audio.	FFmpeg automatically selects an audio stream
videoFilter		Comma-delimited list of additional video filters for FFmpeg to run on the video. If 'none' is included, the default video filters are disabled.
encoderOptions		Options to be passed to the video encoder.	-preset ultrafast -tune zerolatency
debug		Includes debugging output from the main FFmpeg process in the log.	false	true/false