walltheme Download - walltheme Source code download

walltheme

Other source code

1.0.0

Download

Walltheme

Walltheme is a terminal theme generator implemented in Rust. It extracts colors from an image and applies them to predefined templates to generate themes for terminal emulators, text editors, and other applications. The tool supports all standard colors (black, red, white, etc.), and includes an extra orange color specifically for Zellij.

Walltheme comes with several templates and example scripts to facilitate customization.

Features
Installation
- Prerequisites
- Build from Source
Usage
- Basic Command
- Example
Templates
- Example Template
- Provided Templates
Configuration Options
- Example Configuration
- Available Options
Examples
NeoVim Integration
Contributing
License
Acknowledgements
Screenshots
- Generated Themes in Action

Features

Extract Colors from an Image: Automatically extracts primary colors like black, red, white, and others from a provided image.
Zellij Support: Includes an additional orange color for Zellij.
Template-based Generation: Uses customizable templates to generate configuration files for terminals, text editors, and more.
Example Scripts: Predefined scripts and templates for quick integration.
Rust Implementation: High performance and reliability.

Installation

Prerequisites

Rust (https://www.rust-lang.org/tools/install)

Build from Source

# Clone the repository
mkdir -p ~/.cache/walltheme/ && mkdir -p ~/.config/walltheme/templates
git clone https://github.com/JoseMM2002/walltheme.nvim.git
cd walltheme
# Build the project
cargo install --path .

Usage

Basic Command

To generate a theme:

walltheme <image-path>

Example

walltheme ~/Pictures/wallpaper.png

This command extracts colors from wallpaper.png, generates config files using templates from ~/.config/walltheme/templates and saves them into ~/.cache/walltheme/.

Templates

Walltheme uses templates to format the generated theme files. Placeholders are replaced with extracted colors. This templates are generated by handlebars.

Example Template

#{{black_hex}}
#{{red_hex}}
#{{green_hex}}
#{{blue_hex}}
rgb{{black_rgb}}
rgb{{red_rgb}}
rgb{{green_rgb}}
rgb{{blue_rgb}}
rgba{{black_rgba}}
rgba{{red_rgba}}
rgba{{green_rgba}}
rgba{{blue_rgba}}

if the template also needs braces for some configs as oh-my-posh, you can use the following syntax:

{{keep "info to keep betwwen braces"}}

Provided Templates

Walltheme includes templates for:

Kitty Terminal
Waybar
Oh My Posh
Zellij
Nushell
wofi

Templates are located in the templates/ directory. To use them, copy the desired template to ~/.config/walltheme/templates/ and modify it as needed.

Configuration Options

You can customize Walltheme by creating or modifying a config file located at ~/.config/walltheme/config. This file allows you to fine-tune the behavior of the theme generation, including palette settings and thresholds.

Example Configuration

[general]
mix_factor = 0.7 # from 0 to 1
distance_threshold = 0.5 # from 0 to 1
palette_quality = 16 # from 1 to 255
palette_max_colors = 8 # from 1 to 255
brighter_factor = 0.8 # from 0 to 1
bright_min = 20 # from 0 to 255
opacity_target = 50 # from 0 to 255
stdout_template = "colors.sh"

Available Options

mix_factor: Mix factor for blending colors.
distance_threshold: Threshold for color distance filtering.
palette_quality: Quality of the palette extraction.
palette_max_colors: Maximum number of colors to extract.
brighter_factor: Factor to adjust color brightness.
bright_min: Minimum brightness threshold.
stdout_template: Template for standard output.
opacity_target: Target opacity for colors.

You can set these options to suit your preferences and workflow.

Examples

An example for my setup is in the scripts/examples/ directory. It includes a script that sets the wallpaper and generates themes for Kitty, Waybar, and Zellij.