wpgtk

Add wallpaper to collection

$ wpg -a [/path/to/image.jpg]

$ wpg -s [wallpaper.jpg]

$ wpg -l

$ wpg -c

$ wpg -z [wallpaper.jpg]

$ wpg -i [wallpaper.jpg] [colorscheme.json]

$ wpg -t

$ wpgtk

wpg [options] [wallpaper]
wpgtk

wpgtk is a colorscheme, wallpaper, and template manager for Unix-like systems. It uses pywal as its backend to extract colors from wallpapers and apply them system-wide through configurable templates.
The tool generates coordinated colorschemes from wallpaper images, applying them to terminals, GTK themes, window managers, and other applications. Templates define how colors are applied to each application's configuration files. Both a CLI (wpg) and GUI (wpgtk) interface are provided.
Colorschemes are saved with their wallpapers, allowing instant theme switching. Colors can be manually edited, imported from JSON (compatible with terminal.sexy), or auto-adjusted for better contrast.

-a image

Add wallpaper to collection.

Set wallpaper and colorscheme.

List added wallpapers.

Print current wallpaper name.

Delete wallpaper from collection.

Apply colorscheme to terminal.

Shuffle/regenerate colorscheme.

Import colorscheme from JSON file.

Auto-generate foreground colors.

Display help.

Requires pywal as backend. Template files need manual setup for each application. Some applications require restart to apply new colors. GTK theme changes may need session restart.

wpgtk was created by deviantfero to provide a user-friendly interface on top of pywal. While pywal handles color extraction and basic application, wpgtk adds wallpaper management, color editing, template management, and a graphical interface for users who prefer visual configuration.

wal(1), feh(1), nitrogen(1)