Waypaper
  • Waypaper
  • Installation
  • Usage
  • Keybindings
  • Configuration
  • Troubleshooting
  • Support and contribution
Powered by GitBook
On this page
  • Installation
  • Dependencies
Edit on GitHub

Installation

Last updated 3 months ago

Installation

You need to install at least one of the backends and waypaper itself, which works as a frontend.

1. Install a backend

Install a preferred backend from your package manager: or or mpvpaper on Wayland or on Xorg or on both.

2. Install Waypaper

Waypaper is available as a package in different repositories listed below:

On all distributions

pipx install waypaper

If pipx is not found, you first need to install pipx from your package manager, it's sometimes called python-pipx.

On Arch-based distributions

yay -S waypaper or yay -S waypaper-git

The and package is available in AUR, thanks to metak. Please upvote them to support the project. Please understand that the waypaper-git package is not always stable.

On NixOS

The waypaper package is available thanks to Basil Keeler.

On OpenSUSE

On Fedora

Dependencies

  • swww or swaybg or feh or wallutils or hyprpaper

  • gobject python library (it might be called python-gobject or python3-gi or python3-gobject in your package manager.)

  • python-importlib_metadata

  • python-platformdirs

Users of OpenSUSE via pipx install waypaper. This problem might be resolved by installing the python311-pycairo-devel package.

Users reported , which might be resolved by installing cairo-gobject-devel package. Then install with pipx as described above.

If it doesn't work, Waypaper is available in an . So, you can add this repository as sudo dnf copr enable solopasha/hyprland and install as sudo dnf install wayapaper.

swww
swaybg
feh
wallutils
waypaper
waypaper-git
reported problems with installation
issues with installation
external repository owned by Solopasha