# Schedulers

Schedulers enable time-based automatic control of filtration devices, turning them on and off at specified times.

## Accessing Schedulers

Navigate to `/sites/[id]/schedulers` or click "Schedulers" in the site sidebar.

## Concept

Schedules define:

* **Target devices**: Filtration devices to control
* **Start time**: When to turn on
* **Stop time**: When to turn off
* **Days**: Which days of the week

## Schedule Components

### Target Devices

Filtration devices that can be scheduled:

* AirDome
* Clean Air Tower (Self-Cleaning)
* Clean Air Tower (Disposable)

### Time Settings

| Setting    | Description                 |
| ---------- | --------------------------- |
| Start Time | Hour and minute to turn on  |
| Stop Time  | Hour and minute to turn off |
| Timezone   | Site timezone for schedule  |

### Days of Week

Select which days the schedule runs:

* Monday through Sunday
* Weekdays only
* Weekends only
* Custom selection

## Creating Schedules

### Add Schedule Modal

{% stepper %}
{% step %}

### Click "Add Schedule"

Open the modal to create a new schedule.
{% endstep %}

{% step %}

### Enter schedule name

Provide a clear, descriptive name.
{% endstep %}

{% step %}

### Select target device(s)

Choose one or more filtration devices to control.
{% endstep %}

{% step %}

### Set start time

Pick the hour and minute when the device should turn on.
{% endstep %}

{% step %}

### Set stop time

Pick the hour and minute when the device should turn off.
{% endstep %}

{% step %}

### Select days of week

Choose which days the schedule runs (individual days, weekdays, weekends, or a custom selection).
{% endstep %}

{% step %}

### Save schedule

Persist the schedule so it becomes active (if enabled).
{% endstep %}
{% endstepper %}

### Time Format

* 24-hour format recommended
* Timezone-aware scheduling
* Handles overnight schedules

## Schedule Cards

Each schedule displays as a collapsible card:

### Card Header

* Schedule name
* Time range (e.g., "08:00 - 18:00")
* Enable/Disable toggle
* Edit/Delete buttons

### Card Content

* Target device(s) list
* Days of week indicators
* Next scheduled action
* Schedule status

## Managing Schedules

### Enable/Disable

Toggle schedules on/off:

* Disabled schedules don't run
* Preserve for later use
* Quick pause capability

### Edit Schedule

Modify existing schedules:

* Change times
* Adjust days
* Add/remove devices

### Delete Schedule

Remove schedules:

* Confirmation required
* Cannot be undone

## Schedule Execution

### Start Action

{% stepper %}
{% step %}

### System checks schedule

At the start time on scheduled days, the system verifies the schedule is valid and active.
{% endstep %}

{% step %}

### Sends start command to devices

The system issues the start command to the target devices.
{% endstep %}

{% step %}

### Devices begin filtering

Target devices commence filtering operations.
{% endstep %}
{% endstepper %}

### Stop Action

{% stepper %}
{% step %}

### System checks schedule

At the stop time on scheduled days, the system verifies the schedule is active.
{% endstep %}

{% step %}

### Sends stop command to devices

The system issues the stop command to the target devices.
{% endstep %}

{% step %}

### Devices stop filtering

Target devices cease filtering operations.
{% endstep %}
{% endstepper %}

### Crontab Conversion

Internally, schedules convert to cron format:

* Precise timing
* Reliable execution
* Timezone handling

## Overnight Schedules

For schedules crossing midnight:

* Set stop time earlier than start time
* System handles day boundary
* Works correctly across days

Example: Start 22:00, Stop 06:00 = Night shift

## Multiple Schedules

Devices can have multiple schedules:

* Different times for different days
* Overlapping schedules combine
* Consider interactions carefully

## Use Cases

### Production Hours

| Day     | Time        | Purpose       |
| ------- | ----------- | ------------- |
| Mon-Fri | 07:00-18:00 | Day shift     |
| Mon-Fri | 18:00-02:00 | Evening shift |

### Energy Savings

* Run only during production
* Automatic shutdown
* Reduce off-hours consumption

### Air Quality Prep

* Start before work begins
* Pre-filter the air
* Stop after hours

## Best Practices

### Timing

* Allow warm-up time
* Consider start-up sequences
* Account for building access

### Overlap with Automation

* Schedulers set baseline operation
* Automation can override
* Consider combined behavior

### Maintenance Windows

* Disable before service
* Re-enable after
* Use disable toggle

## Empty State

If no schedules exist:

* Message indicating no schedules
* "Add Schedule" button

## Permissions

Creating/editing schedules requires:

* Member or Admin role
* Access to target devices
* Active licenses on devices

## Related Documentation

* [Automation Rules](broken://pages/cdce5e0fc1d3faed280c813b56d173ecb9dcaa33) - PM-based control
* [Notifications](broken://pages/051e9b028bbd84763eebe2cf8123e6858cc5331c) - Email alerts
* [AirDome Functions](file:///6726661/asset-types/airdome/functions.md) - Manual control


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kemperconnect.de/automation/schedulers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.