Pyprpaper

Pyprpaper is a hyprpaper client, its main purpose is to change wallpapers randomly (for given set of monitors) from a given directory(ies).

Features

• Randomly change wallpapers for given monitors.
• Recursive image look-up in all directories.
• Timer to change wallpaper each n seconds.
• Support for none-hyprpaper/hyprland setup.

Installation

You can install pyprpaper using pip:

pip install pyprpaper

It is also available in the AUR (pyprpaper) for the arch linux btw users:

# With yay
yay -S pyprpaper

The PKGBUILD and .SRCINFO files are at rofe33/pyprpaper-aur.

Usage

usage: pyprpaper [-h] [-v] -m monitor1 monitor2 [monitor1 monitor2 ...]
                 [-s SOCKET_PATH] [-k] [-K] [-r]
                 [-f [additional file types ...]] [-t TIMER]
                 path/to/directories [path/to/directories ...]

A simple wallpaper changer.

positional arguments:
  path/to/directories   Path to directories containing the images.

options:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -m monitor1 monitor2 [monitor1 monitor2 ...], --monitors monitor1 monitor2 [monitor1 monitor2 ...]
                        Monitor(s) to change wallpapers on.
  -s SOCKET_PATH, --socket-path SOCKET_PATH
                        Override socket path.
  -k, --keep-wallpapers-loaded
                        Whether to keep wallpapers loaded in RAM or not.
  -K, --keep-wallpapers-consistent
                        Whether to randomly set the same wallpaper for all the
                        monitors.
  -r, --recursive       Whether to recursive get the images from the
                        directories.
  -f [additional file types ...], --additional-file-types [additional file types ...]
                        Additional image file types.
  -t TIMER, --timer TIMER
                        Timer to change the wallpaper each n seconds

All The Glory To Jesus God...

Example

Change wallpaper for all monitors in hyprland/hyprpaper set-up:

pyprpaper -m $(hyprctl -j monitors | jq -r '.[].name' | tr '\n' ' ') -- /path/to/wallpaper/directories

My Hyprpaper/Pyprpaper setup

I am running hyprland/hyprpaper, if you are not using hyprland things will defer depending on what you are using. However pyprpaper will work on any wayland compositor if you are using hyprpaper.

You can have an empty hyprpaper.conf setup and just run pyprpaper in the exec-once in hyprland.conf.

My current hyprpaper.conf config:

splash = off

and in hyprland.conf I have:

exec-once = pyprpaper -t 600 -m $(hyprctl -j monitors | jq -r '.[].name' | tr '\n' ' ') -- /path/to/directory(ies)