Automation Overview

Wallpaper Server is built for automation. Because a single endpoint returns the image itself, most integrations are just “fetch this URL and set it as the wallpaper”.

Why direct images matter

Compare the two approaches:

Metadata API flow:
  request metadata → parse JSON → extract URL or ID → request image → set wallpaper

Direct image flow:
  request image → set wallpaper

The direct-image endpoints (Retrieving images) collapse the whole sequence into one request, which is far easier to express in a shortcut, a Tasker task or a cron job.

The endpoint you will use almost everywhere is:

GET /api/wallpapers/random/image

Add filters to target a mood, size or colour.

Integration guides

Shell and cron — scripts and scheduling on Linux and macOS.
Siri Shortcuts — iOS and macOS Shortcuts.
Tasker — Android automation.
Home Assistant — home automation triggers.
Multi-monitor setups — a different wallpaper per display.