Hyprpaper

Hyprpaper is a simple wallpaper utility for Hyprland. It may be configured through Home Manager declarative options. Option may be found at Home Manager - services-hyprpaper.

Examples for Hyprpaper settings may be found on the Hyprland Wiki on their Hyprpaper page. Entries with the same key should be written as lists, variables’ and colors’ names should be quoted.

Home Manager Configuration (NixOS Stable)

❄︎ /etc/nixos/home.nix

services.hyprpaper = {
  enable = true;
  settings = {
    preload = [
      "~/wallpapers/wallpaper2.jpg"
      "~/wallpapers/wallpaper.jpg"
    ];
    wallpaper = [
      # By display
      #"DP-2,~/wallpapers/wallpaper2.jpg"
      # By default/fallback
      ",~/wallpapers/wallpaper.jpg"
    ];
  };
};

Home Manager Configuration (New)

The following is an example of the new syntax required for services.hyprpaper as of the version supplied by nixos-unstable(26.05). It follows the wallpaper object syntax described on the current Hyprland Wiki.

❄︎ /etc/nixos/home.nix

services.hyprpaper = {
  enable = true;
  settings = {
    preload = [
      "~/wallpapers/wallpaper2.jpg"
      "~/wallpapers/wallpaper.jpg"
    ];
    wallpaper = [
      # By display
      # {
      #   monitor = "DP-2";
      #   path = "~/wallpapers/wallpaper2.jpg";
      # }
      # By default/fallback
      {
        monitor = "";
        path = "~/wallpapers/wallpaper.jpg"; 
      }
    ];
  };
};