ashwal is a fast and lightweight command-line tool for generating dynamic color schemes from images. It extracts dominant colors from your chosen image and applies them to your terminal, applications, and other system components, providing a cohesive and visually appealing desktop experience.

For more details see the Wiki page.

Features

• Dynamic Color Generation: Extracts a vibrant 16-color palette from any image
• Advanced Backend Support: Utilizes imagemagick or libimagequant for efficient color quantization
• Lua Scripting Support: Create custom backends using Lua scripts for advanced color quantization
• Extensive Customization: Fine-tune saturation, contrast, alpha transparency, and theme mode (dark/light)
• Template-Based Output: Generates color schemes for various applications using customizable templates
• Automatic Application Reloading: Seamlessly integrates with your system to apply changes instantly
• Palette Preview: View the generated color palette directly in your terminal
• Random Image Selection: Automatically pick a random image from any specified directory
• Theme Management: Load predefined themes or select random themes based on mode (dark/light/all)

Showcase

• Dark mode

• Light mode

Installation

ashwal requires imagemagick, libimagequant, and lua as dependencies.

Prerequisites

Ensure the following libraries are installed on your system:

• imagemagick
• libimagequant
• lua (or liblua-dev)

Ubuntu/Debian:

sudo apt install imagemagick libimagequant-dev liblua5.4-dev

Arch Linux:

sudo pacman -S imagemagick libimagequant lua

Fedora/RHEL:

sudo dnf install ImageMagick-devel libimagequant-devel lua-devel

macOS

brew install imagemagick libimagequant lua

Arch Linux (AUR)

Install directly from the AUR:

yay -S ashwal
# or
paru -S ashwal

Building from Source

1. Clone the repository:

git clone https://github.com/shadowash8/ashwal.git
cdashwal

2. Build and install:

User-specific:

mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=$HOME/.local ..
make
make install

System-wide:

mkdir build && cd build
cmake ..
make
sudo make install

Documentation

• Getting Started
• Templates
• Advanced Usage
• Plugins

Contributing

Report issues, request features, or contribute via PRs. See the GitHub repository for more info.

License

Licensed under GNU GPL v3.0 — always free and open-source.

Star the project on GitHub if you find it useful!

Special Thanks

• cwal by nitinbhat972

• pywal by dylanaraps

• pywal16 by eylles