Live Data Sources

Live Data Sources display information. They do not perform actions. A WebShell can use LDS values to show system status, app status, media state, weather, service health, or anything else the user configures.

Built-In LDS

WebTrigger includes built-in values that are ready for dashboards and control panels.

`cpu`

Current CPU usage.

`ram`

Current memory usage.

`volume`

Current system volume.

`mute`

Current mute state.

`battery`

Battery level when available.

`battery_charging`

Charging state when available.

Custom LDS

HTTP LDS

Poll a local or remote API, then display a value from the response.

PowerShell LDS

Run a trusted PowerShell command on the PC and display the result.

Python LDS

Use Python for richer local calculations, parsing, or integrations.

Polling

Custom sources update on an interval chosen in the Windows app.

Live Update Flow

Data Source

WebTrigger

LDS Engine

WebShell

User

Live Data API

GET/api/live-data

Read the current live data snapshot.

GET/api/state/stream

Subscribe to live updates with Server-Sent Events.

const values = await fetch('/api/live-data').then(res => res.json());
document.querySelector('[data-lds="cpu"]').textContent = `${values.cpu}%`;

const stream = new EventSource('/api/state/stream');
stream.onmessage = event => {
  const { key, value } = JSON.parse(event.data);
  const target = document.querySelector(`[data-lds="${key}"]`);
  if (target) target.textContent = value;
};

Displaying LDS Values

CPU Card

Show usage, color, and a progress bar for quick system checks.

Weather Card

Display a custom HTTP LDS with temperature and conditions.

Media Card

Show volume, mute state, or current playback information from custom sources.

Server Status Card

Poll a local service or device and show whether it is online.