You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/_components/binary_sensor.ffmpeg.markdown
+17-14Lines changed: 17 additions & 14 deletions
Original file line number
Diff line number
Diff line change
@@ -10,13 +10,14 @@ footer: true
10
10
logo: ffmpeg.png
11
11
ha_category: Binary Sensor
12
12
ha_release: 0.27
13
+
ha_iot_class: "Local Polling"
13
14
---
14
15
15
16
16
-
The `ffmpeg` platform allows you to use every video or audio feed with [FFmpeg](http://www.ffmpeg.org/)as varius sensors in Home Assistant. Avilable are: **noise**, **motion**. If ffmpeg process is brocken, sensor going to unavilable. It exists a service to restart a instance with *binary_sensor.ffmpeg_restart*.
17
+
The `ffmpeg` platform allows you to use every video or audio feed with [FFmpeg](http://www.ffmpeg.org/)for various sensors in Home Assistant. Available are: **noise**, **motion**. If the `ffmpeg` process is brocken, the sensor going to unavailable. It exists a service to restart a instance with *binary_sensor.ffmpeg_restart*.
17
18
18
19
<pclass='note'>
19
-
You need a ffmpeg binary in your system path. On debain 8 you can install it from backports. If you want HW support on raspberry you need self build from source. Windows binary are avilable on ffmpeg homepage.
20
+
You need a `ffmpeg` binary in your system path. On Debain 8 you can install it from backports. If you want Hardware support on a Raspberry Pi you need to build it from sourceby ourself. Windows binary are avilable on [FFmpeg](http://www.ffmpeg.org/) homepage.
20
21
</p>
21
22
22
23
### {% linkable_title Noise %}
@@ -39,23 +40,24 @@ camera:
39
40
Configuration variables:
40
41
41
42
- **input** (*Required*): A ffmpeg compatible input file, stream or feed.
42
-
- **tool** (*Required*): is fix set to 'noise'.
43
+
- **tool** (*Required*): Is fix set to `noise`.
43
44
- **name** (*Optional*): This parameter allows you to override the name of your camera.
44
-
- **ffmpeg_bin** (*Optional*): Default 'ffmpeg'.
45
+
- **ffmpeg_bin** (*Optional*): Default `ffmpeg`.
45
46
- **peak** (*Optional*): Default -30. A peak of dB to detect it as noise. 0 is very loud and -100 is low.
46
47
- **duration** (*Optional*): Default 1 seconds. How long need the noise over the peak to trigger the state.
47
-
- **reset** (*Optional*): Default 20 seconds. The time to reset the state after none new noise is over the peak.
48
-
- **extra_arguments** (*Optional*): Extra option they will pass to ffmpeg. i.e. audio frequence filtering.
49
-
- **output** (*Optional*): Allow you to send the audio output of this sensor to a icecast server or other ffmpeg supported output. i.e. to stream with sonos after state is trigger.
48
+
- **reset** (*Optional*): Defaults to 20 seconds. The time to reset the state after none new noise is over the peak.
49
+
- **extra_arguments** (*Optional*): Extra option they will pass to `ffmpeg`, like audio frequence filtering.
50
+
- **output** (*Optional*): Allow you to send the audio output of this sensor to a icecast server or other ffmpeg supported output, eg. to stream with sonos after state is trigger.
FFmpeg don't have a motion detection filter so it use a scene filter to detect a new scene/motion. In fact you can set how big a object or size of image they need change to detect a motion. The option 'changes' is the percent value of change between frames. You can add a denoice filter to video if you want a realy small value for 'changes'.
60
+
FFmpeg don't have a motion detection filter so it use a scene filter to detect a new scene/motion. In fact you can set how big a object or size of image they need change to detect a motion. The option 'changes' is the percent value of change between frames. You can add a denoise filter to video if you want a realy small value for 'changes'.
59
61
60
62
To enable your FFmpeg with motion detection in your installation, add the following to your `configuration.yaml` file:
61
63
@@ -78,16 +80,17 @@ camera:
78
80
Configuration variables:
79
81
80
82
- **input** (*Required*): A ffmpeg compatible input file, stream or feed.
81
-
- **tool** (*Required*): is fix set to 'motion'.
83
+
- **tool** (*Required*): Is fix set to `motion`.
82
84
- **name** (*Optional*): This parameter allows you to override the name of your camera.
83
-
- **ffmpeg_bin** (*Optional*): Default 'ffmpeg'.
84
-
- **changes** (*Optional*): Default 10 percent. A lower value is more sensitive. I use 4 / 3.5 on my cameras. It describe how mutch of two frames need to change to detect it as motion. See on descripton.
85
+
- **ffmpeg_bin** (*Optional*): Default `ffmpeg`.
86
+
- **changes** (*Optional*): Default 10 percent. A lower value is more sensitive. I use 4 / 3.5 on my cameras. It describe how much of two frames need to change to detect it as motion. See on descripton.
85
87
- **reset** (*Optional*): Default 20 seconds. The time to reset the state after none new motion is detect.
86
88
- **repeat** (*Optional*): Default 0 repeats (deactivate). How many motion need to detect in *repeat_time* to trigger a motion.
87
-
- **repeat_time** (*Optional*): Default 0 seconds (deactivate). The time to repeats befor it trigger a motion.
89
+
- **repeat_time** (*Optional*): Default 0 seconds (deactivate). The time to repeats before it trigger a motion.
88
90
- **extra_arguments** (*Optional*): Extra option they will pass to ffmpeg. i.e. video denoise filtering.
89
91
90
92
For playing with values (changes/100 is the scene value on ffmpeg):
0 commit comments