mpvpaper is a wallpaper program for wlroots based Wayland compositors, such as sway.
The software lets you play videos with mpv as your wallpaper.
mpvpaper manipulates a feature of Wayland called a “surface frame callback”. This feature of Wayland allows mpvpaper to draw/render only when it makes sense to do so.
One reason mpvpaper might not draw/render is if it\’s “hidden”. This is the magic behind the automagic pause/stop options. Whatever “hidden” means is up to compositor. As for Sway, “hidden” is if there is a fullscreen window in the way of the wallpaper. mpvpaper will still draw/render even if there is a normal window blocking the wallpaper view entirely.
This feature is at best a hack that works on some compositors. Usability of these auto options will vary and may not work as intended or at all. In such a case, other features like the “watch lists” mentioned above should be used instead.
This is free and open source software.
Key Features
- Play a video on all output.
- Forward mpv options.
- Control mpvpaper just like mpv in the terminal with keyboard bindings.
Website: github.com/GhostNaN/mpvpaper
Support:
Developer: Henri Hänninen
License: GNU General Public License v3.0

mpvpaper is written in C. Learn C with our recommended free books and free tutorials.
Related Software
| Terminal-Based Diff Tools | |
|---|---|
| difftastic | Structural diff tool that compares files based on their syntax |
| diff-so-fancy | Attractive diffs with diff-highlight and more |
| delta | Viewer for git and diff output |
| icdiff | An improved colored diff |
| diffoscope | In-depth comparison of files, archives, and directories |
| colordiff | Wrapper for diff with pretty syntax highlighting |
| objdiff | Local diffing tool for decompilation project |
| ydiff | Tool to view colored, incremental diff in a version controlled workspace |
| diffr | Word-by-word diff highlighting utility |
| dyff | diff tool for YAML files |
| Wdiff | Wordwise implementation of diff |
| dwdiff | diff program that operates at the word level |
| diff2html-cli | Generate HTML diffs |
| dirdiff | Compute the differences between two directories |
| csv-diff | Diffing CSV and JSON files |
| csvdiff | Fast diff tool for comparing CSV files |
| sesdiff | Generates a shortest edit script |
Read our verdict in the software roundup.
Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form. |


I’d find videos as as desktop wallpaper to be far too distracting.
I’m the same. Good old boring full black background is my staple.
Hi Steve. That’s the other extreme. 🙂
I love desktop wallpapers and have them auto change every 20 minutes.
I think it comes from the day when every byte of RAM was precious and I didn’t have RAM to be fanciful. But I am partial to astronomy pictures on my background, not just dark matter 🙂