omarchy-theme-generator

The Omarchy Theme Generator is a Python-based system that creates cohesive desktop themes by extracting dominant colors from images and mapping them to application configurations. It enables users to generate personalized themes that work across their entire desktop environment, including terminal emulators, window managers, and browsers.

Key Features

• Image-to-Theme Color Extraction — Uses K-means clustering to extract dominant colors from local images or URLs and intelligently maps them to theme categories.
• Centralized Color Management — Defines all colors in a single JSON file with automatic format conversion for different applications.
• Smart Color Mapping — Analyzes brightness, saturation, and perceptual color distance to generate readable and aesthetically pleasing themes.
• Flexible Build System — Automatically deploys generated themes to the Omarchy configuration directory and installs browser themes across multiple Chromium-based browsers.
• Template-Based Configuration — Uses templates to generate application-specific config files (Alacritty, Hyprland, Waybar, etc.) from the central color definitions.

Philosophy

The project emphasizes centralized color management and automation, allowing users to create consistent, visually appealing themes from any image with minimal manual configuration.