Linux Guide 📓

mpvpaper

Last updated: 2024, Mon Jun 3rd at 13:54 CDT

Allowing you to play videos with mpv as your wallpaper, mpvpaper is a wallpaper program for wlroots based wayland compositors.

GitHub

To Install: #

Preferred method

The easiest way to install mpvpaper is manually compiling it.

sudo pacman -S mpvpaper
sudo zypper in mpvpaper

Build Instructions #

Dependencies may be different then the names listed depending the distro. The ones listed below are for APT packages

Dependencies #

You need mpv and wlroots, to build you also need

apt install libmpv-dev ninja-build meson
Build #
git clone --single-branch https://github.com/GhostNaN/mpvpaper
cd mpvpaper
meson setup build --prefix=/usr/local
ninja -C build
ninja -C build install

Essentials #

Simple example to play the same video on all displays. The display, '*' is a wildcard, can also be listed independently, DP-2 for display port 2.

mpvpaper '*' /path/to/video

You can also control mpvpaper in the terminal just like mpv. However if you would like to control mpvpaper outside of the terminal, you could use a mpv input-ipc-server.

Note

More info on usage can be found on GitHub or in man mpvpaper