Static Images¶

gSlapper supports static images with automatic format detection and multiple scaling modes.

Supported Formats¶

JPEG (.jpg, .jpeg)
PNG (.png)
WebP (.webp)
GIF (.gif) - First frame only

Basic Usage¶

gslapper DP-1 /path/to/wallpaper.jpg

Images default to fill mode, which fills the screen while maintaining aspect ratio (cropping excess).

Scaling Modes¶

Fill Mode (Default)¶

Fills the screen maintaining aspect ratio, crops excess:

gslapper -o "fill" DP-1 /path/to/image.png

Stretch Mode¶

Fills screen ignoring aspect ratio:

gslapper -o "stretch" DP-1 /path/to/image.png

Original Resolution¶

Display at native resolution (1:1 pixel mapping):

gslapper -o "original" DP-1 /path/to/image.png

Panscan Mode¶

Fit inside screen with scaling factor:

gslapper -o "panscan=0.8" DP-1 /path/to/image.png

Multiple Monitors¶

# Same image on all monitors
gslapper -o "fill" '*' /path/to/wallpaper.jpg

# Different images per monitor
gslapper -o "fill" DP-1 /path/to/image1.jpg &
gslapper -o "fill" DP-3 /path/to/image2.jpg &

Transitions¶

gSlapper supports smooth fade transitions between images. See Transitions for details.

Making Image Wallpapers Persistent¶

To make your image wallpaper automatically restore after reboot or login, see the Persistent Wallpapers guide. The guide covers multiple methods including systemd service setup, shell scripts, and compositor-specific configuration.