Home Assistant

Home Assistant can pull a wallpaper from your server on a schedule using a shell_command plus a time-triggered automation. This is an example you adapt to your setup — Wallpaper Server has no native Home Assistant integration.

Shell command

Define a command that downloads a wallpaper. Replace the host and output path to match your system:

configuration.yaml

shell_command:
  fetch_wallpaper: >-
    curl --fail --silent
    "http://your-server:8519/api/wallpapers/random/image?brightness=dark"
    --output /config/www/wallpaper.jpg

Automation

Run it on a schedule:

automations.yaml

- alias: Rotate wallpaper each morning
  trigger:
    - platform: time
      at: "07:00:00"
  action:
    - service: shell_command.fetch_wallpaper

Notes

• The --fail flag ensures a failed request (for example a 404 when no wallpaper matches the filters) does not overwrite the file with an error body.
• What you do with the downloaded image — display it on a dashboard, push it to a device, set a screensaver — depends on the rest of your Home Assistant configuration.
• Home Assistant must be able to reach the server. The server has no authentication; see the API overview before exposing it.

Related

• Shell and cron
• Filter reference