CachyOS Apps

Install Waypaper on CachyOS

GUI wallpaper setter for Wayland and Xorg window managers. It works as a frontend for popular wallpaper backends like swaybg, swww, wallutils, hyprpaper and feh.

From the official CachyOS repo. Install with pacman, no AUR helper needed.

Reviewed Nov 2, 2026 · independent guide · Read the Waypaper guide

How do I install Waypaper on CachyOS?

Run this in a terminal, then open Waypaper from your app menu:

sudo pacman -S waypaper

waypaper is in the cachyos repo, the CachyOS project's own package repository, so pacman installs it directly with no AUR helper and no build script. The package is signed with the CachyOS repository key, and pacman checks the signature before it installs.

What should I do after installing Waypaper?

  1. Open Waypaper from your app menu.
  2. It installs these commands: waypaper and waypaperd.
  3. Run pacman -Qi waypaper to see the installed version and the optional dependencies.

Full Waypaper guide: first run, key settings, common fixes and uninstall

How do I update or remove Waypaper?

Update:

sudo pacman -Syu

Remove:

sudo pacman -Rns waypaper

What is Waypaper?

GUI wallpaper manager for Wayland and Xorg Linux systems.

Package description: GUI wallpaper setter for Wayland and Xorg window managers. It works as a frontend for popular wallpaper backends like swaybg, swww, wallutils, hyprpaper and feh.

Reviews of Waypaper on CachyOS

No reviews yet. Be the first to review Waypaper.

    Leave a review

    Your rating

    No login. No links, please. We keep a one way hash of your connection to stop spam, never your IP address. Posts that break the rules may be hidden. Privacy

    From GitHub

    anufrievroman/waypaper · ★ 1,078 stars · last commit Oct 28, 2026 · latest release Aug 30, 2026

    Real issues opened by users on the project's GitHub, shown as written with a link to each one. 10 most reacted issues opened in the last two years plus the 5 newest issues, bots, pull requests, non English and political posts skipped, capped at 15 per repo. Fetched Nov 1, 2026.

    1. hyprpaper with Hyprland 0.53.x issuesClosed

      With the update to Hyprland 0.53.x, hyprpaper isn't working with waypaper anymore. Haven't looked into details so far. Do you see a chance to add a fix in the upcoming version.

      @mylinuxforwork · · 16 reactions · 10 comments · View on GitHub

    2. Does waypaper 2.7 support awwwClosed

      Hi, Swww has been officially replaced in the Arch repos with extra/awww. I need to update the packages of my dotfiles accordingly. Does waypaper in the latest release 2.7 fully works with awww already? When‘s the next release planned? Stephan

      @mylinuxforwork · · 8 reactions · 11 comments · View on GitHub

    3. doesnt work on new hyprlandClosed

      it doesnt work with the new hyprland update, and new hyprpaper.

      @Cyber-Shogun · · 5 reactions · 2 comments · View on GitHub

    4. Support for linux-wallpaperengineClosed

      Could it support linux-wallpaperengine as well for video wallpapers?

      @witchlliee · · 3 reactions · 15 comments · View on GitHub

    5. Nix flake for latest gitClosed

      Hey! I've had issues running Waypaper with awww using the stable NixOS repos. I made a flake.nix that builds your latest git version directly, which works perfectly for me and providing bleeding-edge version. Would you like a PR to add the flake here so other Nix users can run…

      @moonylead1 · · 3 reactions · 1 comments · View on GitHub

    6. after installation errorClosed

      File "/usr/lib/python3.13/site-packages/numpy/core/init.py", line 23, in from . import multiarray File "/usr/lib/python3.13/site-packages/numpy/core/multiarray.py", line 10, in from . import overrides File "/usr/lib/python3.13/site-packages/numpy/core/overrides.py", line 7, in…

      @GAMEA9G · · 2 reactions · 3 comments · View on GitHub

    7. ImportError: taa_ not definedClosed

      On attempting to run waypaper. Python is up to date, so is python-numpy, so is python-imageio, so is python-screeninfo. waypaper-git-2.4.r35.g8819802-1, running on Hyprland, on Arch Zen kernel.

      @ninetailedtori · · 2 reactions · 18 comments · View on GitHub

    8. Support for custom keybindsClosed

      Is it possible to add support for custom keybinds? The reason (for me): hjkl + enter for selecting wallpaper is great if you use both hands, but wasd + space would be more convenient for left-handed setups And I think a lot of people would love an option to configure keybinds to…

      @nekotori55 · · 2 reactions · 2 comments · View on GitHub

    9. .mp4 wallpaper thumbnails doesn't appearOpen

      Using archlinux hyprland

      @hecto600 · · 2 reactions · 14 comments · View on GitHub

    10. Does not save wallpaper settings on dual monitors.Open

      I have installed the ML4W script, on an Arch based system. Prepackaged with ML4W is waypaper, which recognizes my dual monitor set-up when selecting wallpapers. But when I log back in, waypaper sets just one wallpaper to both monitors, or to ‘ALL’ in the settings. I re-installed…

      @cenobite1654 · · 2 reactions · 9 comments · View on GitHub

    11. JPG files aren't detected when using the xwallpaper backendClosed

      When using the xwallpaper backend, .jpg images are not detected, even though .jpeg files are recognized and supported.

      @phreshbrread · · 0 comments · View on GitHub

    12. Does backend = none require an installed wallpaper backend?Closed

      Waypaper’s README says to install at least one wallpaper backend, but Waypaper also exposes backend = none and supports custom scripts through postcommand. This allows users to apply the selected wallpaper through a custom or external backend that is not included in Waypaper’s…

      @La5u · · 0 comments · View on GitHub

    13. License clarificationOpen

      Hi, there's some inconsistency with the license of waypaper. LICENSE says it's GPL-3 but setup.py says it's GPL. Ideally it should be defined in pyproject.toml and proper headers should be used in source files (per GPL license). Context:

      @minorum · · 0 comments · View on GitHub

    14. Can we add argument to open waypaper in zen mode?Closed

      As the title says. It's quite better for fast theming and choosing wallpapers from a folder you already defined.

      @goutosama · · 1 comments · View on GitHub

    15. Not compatible with awwwClosed

      Since swww renamed itself to awww the app doesn't recognize awww and so you just can't set a wallpaper with awww

      @LesesTrickshon · · 1 comments · View on GitHub

    Waypaper on CachyOS: questions

    Is Waypaper in the official CachyOS repo?

    Yes. The waypaper package is in the cachyos repo, version 2.9-1, built 2026-09-20. Install it with sudo pacman -S waypaper.

    Do I need an AUR helper for Waypaper?

    No. It comes from the cachyos repo, so plain pacman installs and updates it, and sudo pacman -Syu keeps it current.

    What is the Waypaper command?

    The package installs waypaper and waypaperd.