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
      # {
      #   monitor = "DP-2";
      #   path = "~/wallpapers/wallpaper2.jpg";
      # }
      # By default/fallback
      {
        monitor = "";
        path = "~/wallpapers/wallpaper.jpg"; 
      }
    ];
  };
};

Home Manager Configuration (NixOS Legacy)

The following is an example of the old services.hyprpaper syntax used before the changes introduced in later nixos 26.05 version.

❄︎ /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"
    ];
  };
};