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 three directory types in File Manager
  • HTTP requests and Lua code
  • KVDB and TableDB actions
  • conditions, variables, and flow control
  • calls to other schedules

When editing a workflow:

  • Search for an action name or category at the top of the node panel, then drag the matching node onto the canvas. Click a category heading to collapse or expand its node list.
  • The top of the canvas provides Undo, Redo, Format nodes, and Fit to canvas. These tools remain available when a node is selected and the properties panel is open.
  • Format nodes arranges node positions and can be undone; Fit to canvas only adjusts the view and keeps node positions unchanged.

Testing and Manual Runs​

  • The workflow editor includes a built-in test run feature, and you can view test logs directly in the editor.
  • Saved schedules can also be run immediately, with real-time run status tracking.
  • When a test or run fails, the panel shows the error location and message, making it easy to return to the corresponding step or node.
  • The run log is collapsed by default when empty and expands automatically when testing or execution starts. You can also collapse it manually during a run; subsequent logs will not keep reopening it.

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.