clrsync

A theme management tool for synchronizing color schemes across multiple applications. clrsync allows to define color palettes once and apply them consistently to all configurable applications.

Features

Unified Color Management: Define color palettes in TOML format and apply them across multiple applications
CLI & GUI: Choose between a command-line interface or a graphical editor
Live Reload: Define post-apply hooks (configurable per template)
Flexible Color Formats: Support for HEX, RGB, HSL with multi-component access (e.g., {color.r}, {color.hex}, {color.hsl})
Color generation: integration with hellwal and matugen

Installation

Linux

Arch Linux

Install the package from AUR using any helper or install manually

yay -S clrsync-git

Ubuntu

Download the latest .deb from the releases page
Install the package

sudo dpkg -i clrsync-<version>.deb

Fedora

Download the latest .rpm from the releases page
Install the package

sudo rpm -i clrsync-<version>.rpm

# or

sudo dnf install clrsync-<version>.rpm

NixOS

Home Manager Module

Add clrsync to your flake inputs

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    home-manager.url = "github:nix-community/home-manager";
    
    clrsync.url = "github:obsqrbtz/clrsync";
  };
}

Add clrsync to flake outputs

outputs =
  {
    self,
    nixpkgs,
    home-manager,
    clrsync,
    ...
  }@inputs:
  let
    system = "x86_64-linux";
    pkgs = nixpkgs.legacyPackages.${system};
  in
  {
    # ...
    homeConfigurations.<Your user name> = home-manager.lib.homeManagerConfiguration {
      inherit pkgs;
      extraSpecialArgs = { inherit inputs; };
      modules = [
        ./home.nix
        clrsync.homeModules.default
      ];
    };
  };

Configure in home manager

programs.clrsync = {
  package = inputs.clrsync.packages.x86_64-linux.default;  
  defaultTheme = "dark";
  palettesPath = "~/.config/clrsync/palettes";
  font = "JetBrainsMono Nerd Font Mono";
  fontSize = 14;
  applyTheme = true;

  templates = {
    kitty = {
      enabled = true;
      inputPath = "~/.config/clrsync/templates/kitty.conf";
      outputPath = "~/.config/kitty/clrsync.conf";
      reloadCmd = "pkill -SIGUSR1 kitty";
    };
    
    rofi = {
      enabled = true;
      inputPath = "~/.config/clrsync/templates/rofi.rasi";
      outputPath = "~/.config/rofi/clrsync.rasi";
    };
  };
};

Rebuild

home-manager switch --flake .

Package

Add clrsync to your flake inputs

{
  inputs = {
    clrsync.url = "github:obsqrbtz/clrsync";
  };
}

Install the package

# In NixOS configuration.nix:
nixpkgs.overlays = [
  inputs.clrsync.overlays.default
];

environment.systemPackages = [
  clrsync
];

Or for home manager:

# flake.nix
pkgs = import nixpkgs {
  inherit system;
  overlays = [
    clrsync.overlays.default
  ];
};

# home.nix
home.packages = [
  clrsync
];

Use the app manually

clrsync_gui

# or
clrsync_cli --apply --theme dark

Install to profile

nix profile add github:obsqrbtz/clrsync

Run without installing

nix run github:obsqrbtz/clrsync
nix run github:obsqrbtz/clrsync#clrsync-cli

Windows

Download the latest installer from the releases page
Run the installer and follow the wizard
Optionally, add the installation dir to your PATH for easier CLI access

Other systems

Follow the steps from Building section then install with cmake:

cd build
cmake --install .

Building

Prerequisites

C++20 compatible compiler (GCC, Clang, or MSVC)
CMake
OpenGL
glfw
fontconfig
freetype

With CMake

mkdir build && cd build
cmake ..
cmake --build .

Configuration

Edit or create a configuration file at ~/.config/clrsync/config.toml:

[general]
palettes_path = "~/.config/clrsync/palettes"
default_theme = "cursed"

[templates.kitty]
input_path = "~/.config/clrsync/templates/kitty.conf"
output_path = "~/.config/kitty/clrsync.conf"
enabled = true
reload_cmd = "pkill -SIGUSR1 kitty"

Palette Files

Example palette file

Create palette files in your palettes_path directory:

# ~/.config/clrsync/palettes/dark.toml
[general]
name = 'cursed'

[colors]
accent = '#B44242FF'
background = '#151515FF'
base00 = '#151515FF'
base01 = '#B44242FF'
base02 = '#95A328FF'
base03 = '#E1C135FF'
base04 = '#60928FFF'
base05 = '#7C435AFF'
base06 = '#A48B4AFF'
base07 = '#C2C2B0FF'
base08 = '#3F3639FF'
base09 = '#DC7671FF'
base0A = '#E8E85AFF'
base0B = '#9E9052FF'
base0C = '#76C39BFF'
base0D = '#86596CFF'
base0E = '#CEB34FFF'
base0F = '#B0AFA8FF'
border = '#3F3639FF'
border_focused = '#E1C135FF'
cursor = '#E1C135FF'
editor_background = '#151515FF'
editor_command = '#CEB34FFF'
editor_comment = '#3F3639FF'
editor_disabled = '#3F3639FF'
editor_emphasis = '#DC7671FF'
editor_error = '#B44242FF'
editor_inactive = '#3F3639FF'
editor_line_number = '#86596CFF'
editor_link = '#60928FFF'
editor_main = '#C2C2B0FF'
editor_selected = '#3F3639FF'
editor_selection_inactive = '#2A2A2AFF'
editor_string = '#76C39BFF'
editor_success = '#95A328FF'
editor_warning = '#E1C135FF'
error = '#B44242FF'
foreground = '#C2C2B0FF'
info = '#60928FFF'
on_background = '#C2C2B0FF'
on_error = '#151515FF'
on_info = '#151515FF'
on_success = '#151515FF'
on_surface = '#C2C2B0FF'
on_surface_variant = '#C2C2B0FF'
on_warning = '#151515FF'
success = '#95A328FF'
surface = '#1C1C1CFF'
surface_variant = '#1C1C1CFF'
warning = '#E1C135FF'

Template Files

Example template file

Create template files at ~/.config/clrsync/templates using color variables:

# ~/.config/clrsync/templates/kitty.conf
cursor              {cursor}
cursor_text_color   {background}
foreground            {foreground}
background            {background}
selection_foreground  {on_surface}
selection_background  {surface}
url_color             {accent}
color0      {base00}
color8      {base08}
color1      {base01}
color9      {base09}
color2      {base02}
color10     {base0A}
color3      {base03}
color11     {base0B}
color4      {base04}
color12     {base0C}
color5      {base05}
color13     {base0D}
color6      {base06}
color14     {base0E}
color7      {base07}
color15     {base0F}

Color Format Specifiers

Format colors using dot notation:

# HEX formats
{color}                    # Default: #RRGGBB
{color.hex}                # #RRGGBB
{color.hex_stripped}       # RRGGBB
{color.hexa}               # #RRGGBBAA
{color.hexa_stripped}      # RRGGBBAA

# RGB components (0-255)
{color.rgb}                # rgb(r, g, b)
{color.r}                  # Red component
{color.g}                  # Green component
{color.b}                  # Blue component

# RGBA (alpha normalized 0-1)
{color.rgba}               # rgba(r, g, b, a)
{color.a}                  # Alpha component

# HSL (hue 0-360, saturation/lightness 0-1)
{color.hsl}                # hsl(h, s, l)
{color.h}                  # Hue component
{color.s}                  # Saturation component
{color.l}                  # Lightness component

# HSLA (hue 0-360, saturation/lightness/alpha 0-1)
{color.hsla}               # hsla(h, s, l, a)
{color.a}                  # Alpha component

Usage

CLI

Basic Commands

List available themes:

clrsync_cli --list-themes

Apply the default theme:

clrsync_cli --apply

Apply a specific theme:

clrsync_cli --apply --theme cursed

Apply a theme from a file path:

clrsync_cli --apply --path /path/to/theme.toml

Show available color variables:

clrsync_cli --show-vars

Use a custom config file:

clrsync_cli --config /path/to/config.toml --apply

Palette Generation

Requires hellwal and/or matugen installed

Generate a palette from an image:

clrsync_cli --generate /path/to/image.png

Generate a palette from a color (hex):

clrsync_cli --generate-color "#B44242" --generator matugen

Generator Options

Hellwal Generator (default):

clrsync_cli --generate image.png --generator hellwal --hellwal-neon --hellwal-dark

Available hellwal options:

--hellwal-neon - Enable neon mode
--hellwal-dark - Prefer dark palettes
--hellwal-light - Prefer light palettes
--hellwal-color - Enable color mode
--hellwal-invert - Invert colors
--hellwal-dark-offset <float> - Dark offset (default: 0.0)
--hellwal-bright-offset <float> - Bright offset (default: 0.0)
--hellwal-gray-scale <float> - Gray scale factor (default: 0.0)

Matugen Generator:

clrsync_cli --generate image.png --generator matugen --matugen-mode dark --matugen-contrast 0.5

Available matugen options:

--matugen-type <type> - Color scheme type (default: "scheme-tonal-spot")
--matugen-mode <mode> - Light or dark mode (default: "dark")
--matugen-contrast <float> - Contrast value from -1 to 1 (default: 0.0)

All Options

-h, --help               Show help message and exit
-v, --version            Print version information and exit
-a, --apply              Apply default theme
-c, --config             Set config file path (default: ~/.config/clrsync/config.toml)
-l, --list-themes        List available themes
-s, --show-vars          Show color keys
-t, --theme              Set theme <theme_name> to apply
-p, --path               Set theme file <path/to/theme> to apply
-g, --generate           Generate palette from <image path>
--generate-color         Generate palette from a color (hex), used with --generator matugen
--generator              Palette generator to use (default: "hellwal")

GUI

Launch the graphical editor:

clrsync_gui

The GUI provides:

Color Scheme Editor: Visual palette editor with color pickers
Template Editor: Edit template files
Live Preview: See changes in real-time

Extras

You may find some pre-configured color schemes and templates in extra directory of this repository.

Acknowledgments

matugen - A material you color generation tool
hellwal - Pywal-like color palette generator, but faster and in C
Dear ImGui - Bloat-free graphical user interface library for C++
GLFW - Multi-platform library for OpenGL, OpenGL ES and Vulkan development
toml++ - Header-only TOML config file parser and serializer for C++17
argparse - Argument Parser for Modern C++
ImGuiColorTextEdit - Syntax highlighting text editor for ImGui

Name		Name	Last commit message	Last commit date
Latest commit History 139 Commits
.github/workflows		.github/workflows
.vscode		.vscode
AUR		AUR
assets		assets
cmake		cmake
example_config		example_config
extra		extra
lib		lib
resources		resources
src		src
.clang-format		.clang-format
.envrc		.envrc
.gitignore		.gitignore
CMakeLists.txt		CMakeLists.txt
CMakePresets.json		CMakePresets.json
LICENSE.txt		LICENSE.txt
README.md		README.md
VERSION		VERSION
VERSION.in		VERSION.in
flake.lock		flake.lock
flake.nix		flake.nix
home-manager-module.nix		home-manager-module.nix
package.nix		package.nix

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

clrsync

Table of Contents

Features

Installation

Linux

Arch Linux

Ubuntu

Fedora

NixOS

Windows

Other systems

Building

Prerequisites

With CMake

Configuration

Palette Files

Template Files

Usage

CLI

Basic Commands

Palette Generation

Generator Options

All Options

GUI

Extras

Acknowledgments

About

Uh oh!

Releases 11

Packages

Languages

License

obsqrbtz/clrsync

Folders and files

Latest commit

History

Repository files navigation

clrsync

Table of Contents

Features

Installation

Linux

Arch Linux

Ubuntu

Fedora

NixOS

Windows

Other systems

Building

Prerequisites

With CMake

Configuration

Palette Files

Template Files

Usage

CLI

Basic Commands

Palette Generation

Generator Options

All Options

GUI

Extras

Acknowledgments

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 11

Packages 0

Languages

Packages