Show task progress as an LED bar
set_progressTurn an OpenRGB LED strip into a progress bar by specifying percent or done/total; completed LEDs stay lit, remaining LEDs dark, with optional color and state.
Instructions
Turn the LED strip into a progress bar: the completed part is lit, the rest is dark.
Pass percent (0-100) or both done and total. color overrides the bar colour (#RRGGBB). state selects the palette entry (default 'working').
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "set_progress"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| done | No | ||
| color | No | ||
| state | No | working | |
| total | No | ||
| detail | No | ||
| percent | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | Yes | ||
| port | Yes | ||
| quota | No | (remaining, total) | |
| ratio | No | ||
| state | Yes | ||
| total | No | ||
| zones | No | ||
| agents | No | all agents currently sharing the lamp | |
| detail | Yes | ||
| device | Yes | ||
| animate | Yes | ||
| control | No | 'global' = the whole strip is controlled as one unit, 'per_led' = every LED is written individually | global |
| percent | No | ||
| agent_id | No | id of this agent in the shared registry | |
| progress | No | 0..1 | |
| restored | No | ||
| led_count | Yes | ||
| remaining | No | ||
| brightness | Yes | ||
| last_error | Yes | ||
| active_mode | Yes | ||
| filled_leds | No | ||
| render_mode | No | 'hardware' = the controller animates on its own, 'per_led' = colours are written LED by LED | per_led |
| state_age_s | Yes | ||
| custom_color | Yes | ||
| display_state | No | state currently shown on the lamp (highest priority of all agents) | idle |
| protocol_version | Yes | ||
| animation_running | Yes |