Skip to content

Getting Started

Jump to bottom
A S H edited this page Mar 23, 2026 · 2 revisions

How to use ashwal 

Usage: ashwal [OPTIONS] --img <image_path>
  • --img <image_path> Specify the image path (required)
  • --mode <dark|light> Set theme mode
  • --cols16-mode <darken|lighten> Set 16-color mode
  • --saturation <float> Overall saturation
  • --contrast <float> Contrast ratio
  • --alpha <float> Alpha transparency (0.0-1.0)
  • --out-dir <path> Output directory for generated files
  • --backend <name> Set image processing backend
  • --script <script_path> Run custom script after processing
  • --no-reload Disable reloading
  • --list-backends List available backends
  • --list-themes List all available themes
  • --quiet Suppress all output
  • --random <directory> Select random image from directory
  • --theme <theme_name|random_dark|random_light|random_all> Select a theme or a random one
  • --preview Preview palette
  • --version Version
  • --help Help

Examples:

ashwal --img /path/to/image.jpg
ashwal --img /path/to/image.png --mode dark --saturation 0.2
ashwal --img /path/to/image.jpg --preview
ashwal --random ~/Pictures/wallpapers
ashwal --theme random_dark
ashwal --theme random_light
ashwal --theme random_all
ashwal --list-themes
ashwal --img /path/to/image.jpg --out-dir ~/.config/colors --script ~/.local/bin/reload-apps.sh

Clone this wiki locally