User Guide
Video Wallpapers
gSlapper supports all video formats that GStreamer can decode, including MP4, MKV, WebM, AVI, MOV, and more.
gSlapper supports all video formats that GStreamer can decode, including MP4, MKV, WebM, AVI, MOV, and more.
Basic Usage
gslapper DP-1 /path/to/video.mp4Looping
To loop a video seamlessly:
gslapper -o "loop" DP-1 /path/to/video.mp4Scaling Options
Fit to Screen (Default)
gslapper -o "loop panscan=1.0" DP-1 /path/to/video.mp4Scale with Factor
# Scale to 80% of screen size
gslapper -o "loop panscan=0.8" DP-1 /path/to/video.mp4Stretch to Fill
gslapper -o "loop stretch" DP-1 /path/to/video.mp4Original Resolution
gslapper -o "loop original" DP-1 /path/to/video.mp4Multiple Monitors
Same Video on All Monitors
gslapper -o "loop" '*' /path/to/video.mp4Different Videos per Monitor
gslapper -o "loop" DP-1 /path/to/video1.mp4 &
gslapper -o "loop" DP-3 /path/to/video2.mp4 &Audio
By default, audio is enabled. To disable:
gslapper -o "loop no-audio" DP-1 /path/to/video.mp4Background Mode
Run in the background:
gslapper -f -o "loop" DP-1 /path/to/video.mp4Supported Formats
- MP4 (H.264, H.265)
- MKV
- WebM
- AVI
- MOV
- Any format supported by GStreamer
Codec Support
Ensure you have gst-plugins-ugly and gst-libav installed for H.264/H.265 support.
Making Video Wallpapers Persistent
To make your video 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.