Skip to content

Multi-Monitor Setups

Wallpaper Server does not manage monitors itself. Instead, it makes multi-monitor setups easy by letting you make one filtered request per display and then applying each image with your desktop’s own wallpaper command.

The pattern

Request a wallpaper tuned to each screen’s shape, then set them independently:

#!/usr/bin/env sh
set -eu

base="http://your-server:8519/api/wallpapers/random/image"

# An ultrawide for the main display, a portrait for the vertical one.
curl --fail --silent "$base?aspect_ratio=ultrawide" --output /tmp/wall-main.jpg
curl --fail --silent "$base?orientation=portrait"   --output /tmp/wall-side.jpg

# Apply with your desktop's per-monitor wallpaper command, for example:
# (placeholder — substitute the correct command for your environment)
# set-wallpaper --monitor 0 /tmp/wall-main.jpg
# set-wallpaper --monitor 1 /tmp/wall-side.jpg

Tips

Use aspect_ratio and orientation to match each monitor’s geometry.
Use min_width/min_height to avoid upscaling a small image onto a large panel.
Schedule the script with cron or a timer.