Skip to content
Projets

GhostNaN/mpvpaper has 1,659 GitHub stars and 54 forks. GitHot measured -1 stars in 24 hours, +5 in 7 days, and +10 in 15 days. Last checked 2026-11-19 20:04 UTC. Last push 2026-08-29.

Comment ces chiffres sont mesurés

Progression mesurée des étoiles

in 24h
-1
in 7 days
+5
in 15 days
+10
in 1 month
Historique en cours

Variations nettes sur des périodes qui se chevauchent, pas des totaux quotidiens. Les mesures absentes restent vides. Les étoiles indiquent l’intérêt, pas la qualité.

À propos

A video wallpaper program for wlroots based wayland compositors.

Création et médias

README.md

Original

Preview

mpvpaper

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

Dependencies

Building

Building Requirements:

  • ninja
  • meson
  • libmpv

Clone | Build | Install:

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

Usage

Simple example:

mpvpaper DP-2 /path/to/video

To play the same video on all outputs:

mpvpaper ALL /path/to/video

You can also forward mpv options by passing "--mpv-options" or "-o" like so:

mpvpaper -o "no-audio --loop-playlist shuffle" HDMI-A-1 www.url/to/playlist

You can also control mpvpaper just like mpv in the terminal with keyboard bindings.

But if you would like to control mpvpaper while it's forked, you could use a mpv input-ipc-server like this:

mpvpaper -o "input-ipc-server=/tmp/mpv-socket" DP-1 /path/to/video

Then input commands with socat. For example, toggle pause:

echo 'cycle pause' | socat - /tmp/mpv-socket

For more mpv commands read: https://mpv.io/manual/master/#command-interface

You can also take a look at scripts page for ideas or refrences.

For more info on mpvpaper, please refer the the man page.

Acknowledgments

License

This project is licensed under the GPLv3 License - see the LICENSE file for details