Table of Contents

• Introduction
• Setting a Static Wallpaper
  • Using hyprL-config
  • Manual Setup with swww
• Wallpaper Automation
  • Enabling/Disabling Automation
  • Configuring Automation Interval
• Wallpaper Effects
  • Applying Effects
  • Custom Effects
• Wallpaper Storage
• Troubleshooting Wallpaper Issues

Introduction

HyprL provides flexible options for managing your desktop wallpapers, including setting static images, automated rotation, and applying visual effects. The system primarily uses swww for setting wallpapers and integrates with pywal and matugen for dynamic color schemes.

Setting a Static Wallpaper

Using hyprL-config

The easiest way to set a static wallpaper is through the interactive hyprL-config tool:

1. Open a terminal and run hyprL-config.
2. Select 4. 🖼️ Wallpaper Settings.
3. Select 1. Set Static Wallpaper.
4. The tool will list images found in your ~/.wallpaper/ directory, and you can select one.

Manual Setup with swww

HyprL uses swww to set wallpapers. You can manually set a wallpaper from the command line:

swww img /path/to/your/wallpaper.jpg

This command will set the specified image as your desktop background.

Wallpaper Automation

HyprL includes a script to automatically rotate your wallpapers from a designated folder.

Enabling/Disabling Automation

Wallpaper automation can be toggled using the wallpaper-automation.sh script:

~/.config/hypr/scripts/wallpaper-automation.sh

Running this script will start or stop the automatic wallpaper rotation process. When started, it will notify you that the process has begun and the interval at which wallpapers will change.

Configuring Automation Interval

The interval for wallpaper automation is defined in ~/.config/hyprL/settings/wallpaper-automation.sh. You can edit this file to change the value to your desired rotation time in seconds.

# Example: Change wallpaper every 60 seconds (1 minute)
60

Troubleshooting Wallpaper Issues

If you encounter problems with wallpapers not loading or effects not applying, refer to the Common Issues documentation, specifically the “Wallpaper Issues” section. You can also check the swww status and logs for errors.