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.