# Waypaper

GUI wallpaper setter for Wayland and Xorg window managers on Linux. It works as a frontend for popular wallpaper backends like `swaybg`, `swww`, `wallutils`, `hyprpaper` and `feh`. Developed by [Roman Anufriev](https://anufrievroman.gitbook.io/anufriev-roman/) since 2023.

<figure><img src="/files/eXjrLqV5nLMAat3jjKZf" alt=""><figcaption></figcaption></figure>

### Features

* Vim-style keyboard navigation
* Support for GIF animations (with `swww`, `awww`, `mpvpaper`, or `gslapper`)
* Support for video wallpapers (with `mpvpaper`, `gslapper`, or `linux-wallpaperengine`)
* Support for multiple monitors
* Works on Wayland (with `swww`, `awww`, `swaybg`, `hyprpaper`, `mpvpaper`, `gslapper`, or `wallutils`)
* Works on Xorg (with `feh`, `xwallpaper`, or `wallutils`)
* Works on macOS (native support)
* Restores wallpaper at launch of your WM
* Caching for fast loading
* Zen mode for a minimal, distraction-free interface
* Post-command hook to run a script after each wallpaper change
* Customizable CSS stylesheet for theming

### Contents

* [Installation](/waypaper/installation.md)
* [Usage](/waypaper/usage.md)
* [Keybindings](/waypaper/keybindings.md)
* [Configuration](/waypaper/configuration.md)
* [Troubleshooting](/waypaper/troubleshooting.md)
* [Support and contribution](/waypaper/support-and-contribution.md)

### Demo

{% embed url="<https://www.youtube.com/watch?v=O9OL7iH_KVY>" %}

### Repositories

* Code: <https://github.com/anufrievroman/waypaper>
* Documentation: <https://github.com/anufrievroman/waypaper-docs>

If you enjoy using Waypaper, please consider [supporting](/waypaper/support-and-contribution.md) the project.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://anufrievroman.gitbook.io/waypaper/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.