Hyprpaper picker

Blazing fast wallpaper changer for Hyprland.

Table of Contents

• Requirements
• Installation (only manual for now)
• Usage
• Arguments
• Flags
• Contributing
• License

Requirements

• Rust with Cargo
• Hyprland
• Hyprpaper

Installation

• Clone the repository

   git clone https://github.com/aragami3070/hyprpaper-picker.git
   cd hyprpaper-picker

• Build the project

   cargo build --release

• Add the binary to your /bin directory (this important because from other directories hyprland can't find it)

   ln --symbolic target/release/hyprpaper-picker /bin/hyprpaper-picker

Usage

You can bind the command to a key in Hyprland.

For example, if you can bind the command to Super+Shift+W key, to change on random wallpaper from dir:

# In hyprland.conf
$mainMod = SUPER # Sets "Windows" key as main modifier
# Path to the directory with wallpapers
$wallpaperDir = $(dirname $(hyprctl hyprpaper listactive | head -n1 | awk -F'=' '{print $2}' | awk -F'.' '{print $1"."$2}'))
# Or you can hardcode it like this
# $wallpaperDir = /home/aragami3070/wallpapers
bind = $mainMod SHIFT, W, exec, hyprpaper-picker rand -d $wallpaperDir

Arguments

• rand - choose random wallpaper from dir
• next - choose next wallpaper from dir
• prev - choose prev wallpaper from dir

Flags

• -d - path to the directory with wallpapers

Contributing

See CONTRIBUTING.md.

License

License