Skip to content

Cameras Config

Jump to bottom
SeydX edited this page Jan 25, 2022 · 1 revision

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

Sidebar

Clone this wiki locally