Skip to content

Quick Start

Get gSlapper running in under a minute!

Basic Video Wallpaper

gslapper DP-1 /path/to/video.mp4

Replace DP-1 with your monitor name (use gslapper -d to list available monitors).

Basic Image Wallpaper

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

Images default to "fill" mode, which fills the screen while maintaining aspect ratio.

With Looping

gslapper -o "loop" DP-1 /path/to/video.mp4

All Monitors

gslapper -o "loop" '*' /path/to/video.mp4

Background Mode

Run in the background:

gslapper -f -o "loop" DP-1 /path/to/video.mp4

With Image Cache (Instant Switching)

Cache images in RAM for near-instant wallpaper changes:

# Start with cache enabled (256 MB)
gslapper --cache-size 256 -I /tmp/gslapper.sock DP-1 /path/to/image1.jpg

# Switch to another image instantly (via IPC)
echo "change /path/to/image2.jpg" | nc -U /tmp/gslapper.sock

# Check cache usage
echo "cache-stats" | nc -U /tmp/gslapper.sock

What happens: - First image is automatically cached when displayed - Subsequent change commands cache new images on-the-fly - Switching back to a cached image is near-instant (no re-decode) - LRU eviction removes least-recently-used images when cache is full

Making Wallpapers Persistent

To make your wallpaper survive reboots and logins, see the Persistent Wallpapers guide. It covers: - Systemd service setup (recommended) - Shell script startup - Compositor-specific configuration - Manual restoration

Next Steps