mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-19 07:17:14 +00:00
Add config flow to Folder Watcher (#30321)
This commit is contained in:
parent
6a0bee32f3
commit
05f7d265a6
@ -4,6 +4,7 @@ description: Integration for monitoring changes within the filesystem.
|
||||
ha_category:
|
||||
- System monitor
|
||||
ha_iot_class: Local Polling
|
||||
ha_config_flow: true
|
||||
ha_release: 0.67
|
||||
ha_quality_scale: internal
|
||||
ha_domain: folder_watcher
|
||||
@ -20,38 +21,12 @@ This integration adds [Watchdog](https://pythonhosted.org/watchdog/) file system
|
||||
|
||||
Configured folders must be added to [allowlist_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:
|
||||
|
||||
```yaml
|
||||
folder_watcher:
|
||||
- folder: /config
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
folder:
|
||||
description: The folder path
|
||||
required: true
|
||||
type: string
|
||||
patterns:
|
||||
description: Pattern matching to apply
|
||||
required: false
|
||||
default: "`*`"
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
## 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`.
|
||||
|
||||
```yaml
|
||||
folder_watcher:
|
||||
- folder: /config
|
||||
patterns:
|
||||
- '*.yaml'
|
||||
- '*.txt'
|
||||
```
|
||||
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.
|
||||
As example to monitor specific file, as example YAML and text-files add `*.yaml` and `*.txt`.
|
||||
|
||||
## Automations
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user