Skip to main content

# Schedules and Workflows

The schedules panel supports both step-based jobs and visual workflows. You can use it as a scheduler for regular tasks or as a visual automation tool.

## Supported Trigger Types​

- `Cron`
- `Interval`
- `One Time`
- `User Triggered`
- `KVDB Queue Consume`

Notes:

- `User Triggered` schedules do not run automatically. They only run when started manually.
- `KVDB Queue Consume` is useful when you want a schedule to run whenever work is pulled from a queue.

## Target Devices and Groups​

- Schedules use the same device and group logic as the main screen.
- If a schedule selects groups, those groups still use their currently bound scripts and settings at runtime.
- For `User Triggered` schedules, you can also control whether the action appears under `More Actions`, and whether device selection is required before triggering it.

## Two Editing Modes​

### Step Mode​

Good for simple serial actions such as:

- launch script
- stop, pause, or resume script
- lock or unlock screen
- respring SpringBoard or reboot device
- wait for a number of seconds
- run Lua code
- enable, disable, or trigger another schedule

### Workflow Mode​

Good for more complex automations. The workflow editor can combine:

- device actions and script execution
- file operations across the app's main managed directories
- HTTP requests and Lua code
- KVDB and TableDB actions
- conditions, variables, and flow control
- calls to other schedules

## Testing and Manual Runs​

- The workflow editor includes a built-in test run feature.
- Saved schedules can also be run immediately.
- When a test or run fails, the panel shows the error and makes it easier to return to the related step or node.

## Run History and Export​

- Every schedule keeps a run history.
- You can inspect run status, trigger source, device result counts, and logs.
- Run logs can be exported into `File Manager → Reports Directory`.

## Bulk List Actions​

- The schedules list supports multi-select and `Shift` range selection.
- Selected schedules can be exported or deleted in bulk.
- Bulk deletion asks for confirmation first. Schedules with running runs cannot be deleted.

## Import and Export​

- The schedules list can export all schedules, or only one or more selected schedules.
- When exporting selected schedules, related schedules referenced by steps or workflow nodes are included automatically so the import package stays usable.
- `Import schedules` previews the schedules inside the JSON file first, and you can import only one or several of them.
- You can choose a JSON file with `Import schedules`, or drag a JSON file directly into the schedules panel.
- The new import entry merges into the current list by default. It does not replace all existing schedules.
- When a schedule name already exists, you can overwrite the existing schedule or import it with a new name.