Siri Shortcuts

Apple Shortcuts can fetch a wallpaper from your server and hand it to the system wallpaper action. This works because the direct-image endpoint returns the image directly.

Building the shortcut

1. Add a Get Contents of URL action.

2. Set the URL to your direct-image endpoint, for example:

   http://your-server:8519/api/wallpapers/random/image?orientation=portrait

3. The action’s output is the image itself.

4. Add the Set Wallpaper action and pass it the output of the previous step.

Replace your-server with your server’s address, reachable from the device.

Note

Action names and available options differ between iOS/iPadOS and macOS versions. The two building blocks — fetching the URL and setting the wallpaper — are the stable part of the workflow.

What belongs where

• On the server: choose the endpoint and filters that select the wallpaper you want.
• In Shortcuts: the request and the wallpaper action.
• Outside your control: whether Apple allows a given automation to change the wallpaper unattended. Some OS versions require the shortcut to be run manually or confirmed. This is an Apple platform restriction, not a server setting.

Reachability

The device running the shortcut must be able to reach the server. On a phone that means being on the same network, or exposing the server through a secure remote-access solution. Remember the server has no authentication — see the API overview for exposure guidance.