A drop-in replacement for mpvpaper using GStreamer instead of libmpv. Fixes memory leaks on NVIDIA Wayland systems and provides better multi-monitor support.

Benchmark results (NVIDIA RTX, dual monitors, 1-hour test):

Run your own benchmark: ./benchmark.sh benchmark-test-video.mp4 -t 300

yay -S gslapper

git clone https://github.com/Nomadcxx/gSlapper.git
cd gSlapper
meson setup build --prefix=/usr/local
ninja -C build
sudo ninja -C build install

# Arch Linux
sudo pacman -S gstreamer gst-plugins-base gst-plugins-good gst-plugins-bad

# Ubuntu/Debian
sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad

# Basic usage
gslapper DP-1 /path/to/video.mp4

# With looping and scaling
gslapper -v -o "loop panscan=0.8" DP-1 /path/to/video.mp4

# Stretch to fill (ignore aspect ratio)
gslapper -v -o "loop stretch" DP-1 /path/to/video.mp4

# Original resolution (1:1 pixel mapping)
gslapper -v -o "loop original" DP-1 /path/to/video.mp4

# All monitors
gslapper -v -o "loop" '*' /path/to/video.mp4

# Different videos per monitor
gslapper -o "loop" DP-1 /path/to/video1.mp4 &
gslapper -o "loop" DP-3 /path/to/video2.mp4 &

• -v, -vv - Verbose output (use -vv for more detail)
• -f - Fork to background
• -p - Auto-pause when wallpaper is hidden
• -s - Auto-stop when wallpaper is hidden
• -l LAYER - Shell layer (background, bottom, top, overlay)
• -o "OPTIONS" - Video options (space-separated):
  • loop - Seamless video looping
  • panscan=X - Scale video (0.0-1.0, default 1.0 = fit to screen)
  • stretch - Stretch to fill screen (ignore aspect ratio)
  • original - Display at native resolution (1:1 pixel mapping)
  • no-audio - Disable audio playback

Uses mpvpaper config files:

• ~/.config/mpvpaper/pauselist - Apps that pause playback
• ~/.config/mpvpaper/stoplist - Apps that stop playback

Compatible with Hyprland, Sway, and wlroots compositors.

gSlapper replaces libmpv with GStreamer to solve:

• Memory leaks on NVIDIA Wayland
• Poor GPU resource cleanup
• Multi-monitor crashes

GStreamer provides mature Wayland/EGL integration and proper hardware acceleration.

MIT License - see LICENSE

• mpvpaper - Original inspiration
• GStreamer - Multimedia framework
• Clapper - GStreamer integration patterns