mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-31 23:36:50 +00:00
1833c32a2c
* Sets front matter defaults * Removes default front matter from section templates/pages * Removes default front matter from addon pages * Removes default front matter from integration pages * Removes default front matter from posts * Removes default front matter from docs pages * Removes default front matter from other pages * Fixes blog category pages
36 lines
1.1 KiB
Markdown
36 lines
1.1 KiB
Markdown
---
|
|
title: "Folder sensor"
|
|
description: "Sensor for monitoring the contents of a folder."
|
|
logo: file.png
|
|
ha_category:
|
|
- Utility
|
|
ha_iot_class: Local Polling
|
|
ha_release: 0.64
|
|
redirect_from:
|
|
- /components/sensor.folder/
|
|
---
|
|
|
|
Sensor for monitoring the contents of a folder. Note that folder paths must be added to [whitelist_external_dirs](/docs/configuration/basic/). Optionally a [wildcard filter](https://docs.python.org/3.6/library/fnmatch.html) can be applied to the files considered within the folder. The state of the sensor is the size in MB of files within the folder that meet the filter criteria. The number of filtered files in the folder and total size in bytes of those files are exposed as attributes.
|
|
|
|
## Configuration
|
|
|
|
To enable the `folder` sensor in your installation, add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
sensor:
|
|
- platform: folder
|
|
folder: /config
|
|
```
|
|
|
|
{% configuration %}
|
|
folder:
|
|
description: The folder path
|
|
required: true
|
|
type: string
|
|
filter:
|
|
description: Filter to apply
|
|
required: false
|
|
default: "`*`"
|
|
type: string
|
|
{% endconfiguration %}
|