HyprQuickPaper

Anto426 fork of iamsurjog/hyprquickpaper, a Quickshell wallpaper selector inspired by ilyamiro's dots.

This fork is wired for the Anto426 Hyprland/dotfiles stack:

• centered full-screen preview backdrop for the currently selected wallpaper
• per-image accent colors from the wallpaper cache
• image and video wallpaper thumbnails
• generated config.json and commands.sh so paths stay machine-local
• integration with ~/.config/anto426/wallpaper_apply.sh

Dependencies

• quickshell
• jq
• file
• imagemagick (magick, with convert fallback)
• ffmpeg or ffmpegthumbnailer for video thumbnails

Install

git clone https://github.com/Arch-repo/hyprquickpaper.git ~/Git/arch/hyprquickpaper
~/Git/arch/hyprquickpaper/install.sh

The installer copies shell.qml and cache.sh to:

~/.config/quickshell/hyprquickpaper

It then writes a local config.json and commands.sh. These files are intentionally ignored by git.

Useful overrides:

ANTO426_WALLPAPERS_DIR="$HOME/Pictures/Wallpapers" \
ANTO426_HYPRQUICKPAPER_CACHE="$HOME/.cache/quickshell/hyprquickpaper/thumbs" \
ANTO426_WALLPAPER_APPLY="$HOME/.config/anto426/wallpaper_apply.sh" \
~/Git/arch/hyprquickpaper/install.sh

Usage

The Anto426 dotfiles launch the selector through:

~/.config/anto426/wallpaper_select.sh

Standalone launch:

~/.config/quickshell/hyprquickpaper/cache.sh ~/.config/quickshell/hyprquickpaper
quickshell --no-duplicate -c hyprquickpaper

Keys:

• J / Right: next wallpaper
• K / Left: previous wallpaper
• D / PageDown: jump forward
• U / PageUp: jump backward
• Space / Enter: apply selected wallpaper
• Esc: close

Runtime Files

config.example.json and commands.example.sh show the shape of the generated runtime files. Do not commit local config.json, commands.sh, or thumbnail cache contents.