Skip to main content
Version: main

hyprpaper

Generate configuration for Hyprpaper wallpaper manager.

Description​

Hyprpaper is the wallpaper utility for Hyprland. The plugin generates a configuration file and automatically sets your wallpaper when generating from an image source.

Output path​

~/.config/hypr/tinct-hyprpaper.conf

Usage​

tinct generate -i image -p ~/wallpaper.jpg -o hyprpaper

When generating from an image, the wallpaper is automatically applied to all monitors using Hyprpaper's IPC.

Flags​

FlagDefaultDescription
--hyprpaper.output-dir~/.config/hyprOutput directory for Hyprpaper config

Configuration​

Manual configuration​

Include the generated config in your Hyprpaper configuration.

For Hyprpaper < 0.8.0, add to your ~/.config/hypr/hyprpaper.conf:

source = ~/.config/hypr/tinct-hyprpaper.conf

Hyprpaper v0.8.0 removed support for the source directive. For this version, tinct automatically:

  1. Creates tinct-hyprpaper.conf with wallpaper settings
  2. Creates a symlink: hyprpaper.conf -> tinct-hyprpaper.conf
  3. Backs up any existing hyprpaper.conf to hyprpaper.conf.bak

Versioned templates​

Tinct detects your installed Hyprpaper version and uses appropriate templates:

  • < 0.8.0: Uses legacy configuration with preload and wallpaper commands
  • >= 0.8.0: Uses new IPC syntax and symlink approach

Version detection runs hyprpaper -h to extract the version number.

Automatic wallpaper application​

When generating from an image source, tinct applies the wallpaper immediately:

Hyprpaper 0.8.0+​

hyprctl hyprpaper wallpaper ',/path/to/wallpaper,'

Hyprpaper < 0.8.0​

hyprctl hyprpaper unload all
hyprctl hyprpaper preload /path/to/wallpaper
hyprctl hyprpaper wallpaper ",/path/to/wallpaper"

Generated format​

# Hyprpaper configuration generated by tinct

preload = /path/to/wallpaper.jpg
wallpaper = ,/path/to/wallpaper.jpg

splash = false

Multiple monitors​

The plugin detects your current monitor configuration and applies wallpapers to all active monitors. For custom per-monitor wallpapers, edit the generated configuration file manually.

See also​