wal
Generate color schemes from images
TLDR
SYNOPSIS
wal [-a alpha] [-b background] [-i image] [-l] [-n] [--theme name] [options]
DESCRIPTION
wal (pywal) generates color schemes by extracting dominant colors from wallpaper images and applies them to the terminal emulator, shell, and other applications. It creates a cohesive visual theme across the desktop environment based on a single source image.
The extracted color palette is applied to terminal colors in real time and can be used to generate configuration files for other programs through a template system. This allows applications like i3, polybar, rofi, and many others to automatically adopt the same color scheme.
Generated themes are cached for quick switching, and previous color schemes can be restored on login. Both light and dark color variants are supported, and the wallpaper-setting step can be skipped when only the colors are needed.
PARAMETERS
-i IMAGE
Input image or directory of images.-l
Generate light colorscheme.-n
Skip setting the wallpaper.--theme NAME
Use a theme file (use without argument to list themes).-R
Restore previous colorscheme.-c
Delete all cached colorschemes.-a ALPHA
Set terminal background transparency (URxvt only).-b COLOR
Custom background color to use.--backend BACKEND
Color backend to use (use without argument to list backends).--saturate 0.0-1.0
Set color saturation level.-o SCRIPT
External script to run after wal finishes.-q
Quiet mode, suppress output.-s
Skip changing colors in terminals.-t
Skip changing colors in TTY.
CAVEATS
Python required. Terminal support varies. X11/Wayland differences.
HISTORY
pywal was created to generate and apply color schemes from images to terminals and applications.
