mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-10 04:06:48 +00:00
81 lines
2.2 KiB
Markdown
81 lines
2.2 KiB
Markdown
---
|
||
title: Folder Watcher
|
||
description: Component for monitoring changes within the filesystem.
|
||
ha_category:
|
||
- System Monitor
|
||
ha_iot_class: Local Polling
|
||
ha_release: 0.67
|
||
ha_quality_scale: internal
|
||
ha_domain: folder_watcher
|
||
---
|
||
|
||
This integration adds [Watchdog](https://pythonhosted.org/watchdog/) file system monitoring, publishing events on the Home Assistant bus on the creation/deletion/modification of files within configured folders. The monitored `event_type` are:
|
||
|
||
* `created`
|
||
* `deleted`
|
||
* `modified`
|
||
* `moved`
|
||
|
||
Configured folders must be added to [whitelist_external_dirs](/docs/configuration/basic/). Note that by default folder monitoring is recursive, meaning that the contents of sub-folders are also monitored.
|
||
|
||
## Configuration
|
||
|
||
To enable the Folder Watcher integration in your installation, add the following to your `configuration.yaml` file:
|
||
|
||
{% raw %}
|
||
```yaml
|
||
folder_watcher:
|
||
- folder: /config
|
||
```
|
||
{% endraw %}
|
||
|
||
{% configuration %}
|
||
folder:
|
||
description: The folder path
|
||
required: true
|
||
type: string
|
||
patterns:
|
||
description: Pattern matching to apply
|
||
required: false
|
||
default: "*"
|
||
type: string
|
||
{% endconfiguration %}
|
||
|
||
## Patterns
|
||
|
||
Pattern matching using [fnmatch](https://docs.python.org/3.6/library/fnmatch.html) can be used to limit filesystem monitoring to only files which match the configured patterns. The following example shows the configuration required to only monitor filetypes `.yaml` and `.txt`.
|
||
|
||
{% raw %}
|
||
```yaml
|
||
folder_watcher:
|
||
- folder: /config
|
||
patterns:
|
||
- '*.yaml'
|
||
- '*.txt'
|
||
```
|
||
{% endraw %}
|
||
|
||
## Automations
|
||
|
||
Automations can be triggered on filesystem event data using a `data_template`. The following automation will send a notification with the name and folder of new files added to that folder:
|
||
|
||
{% raw %}
|
||
```yaml
|
||
#Send notification for new image (including the image itself)
|
||
automation:
|
||
alias: New file alert
|
||
trigger:
|
||
platform: event
|
||
event_type: folder_watcher
|
||
event_data:
|
||
event_type: created
|
||
action:
|
||
service: notify.notify
|
||
data_template:
|
||
title: New image captured!
|
||
message: "Created {{ trigger.event.data.file }} in {{ trigger.event.data.folder }}"
|
||
data:
|
||
file: "{{ trigger.event.data.path }}"
|
||
```
|
||
{% endraw %}
|