set_wallpaper
Assign a wallpaper image to a specific monitor or set a fallback wallpaper for all unassigned monitors. Loads the image on demand.
Instructions
Set the wallpaper for a monitor (or the fallback for all monitors that don't have one specifically assigned, if monitor is omitted). Loads the image on demand — no separate preload step needed on current hyprpaper versions.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "set_wallpaper"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Path to the image file | |
| monitor | No | Monitor name from list_monitors, e.g. 'DP-1'; omit to set the fallback wallpaper | |
| fit_mode | No | e.g. 'cover' (default), 'contain', 'tile' — exact supported values can vary by hyprpaper version; omit to use hyprpaper's own default |