Graphite Theme Patcher

Effortlessly customize Graphite's primary color and more without forking the project using the Graphite Theme Patcher. Designed for advanced users, this tool simplifies theme adjustments with minimal hassle.

Overview

The Graphite Theme Patcher allows you to:

• Adjust the primary accent color.
• Replace specific theme tokens for deeper customization.

This tool is ideal for tinkerers and power users familiar with script and configuration editing.

INFO

Changes made with this patcher are temporary. Updates to the Graphite theme will overwrite customizations unless automated workflows are in place.

Installation

Step 1: Download the Patcher

Save the graphite-theme-patcher.py script to your /config/scripts directory. If the directory doesn't exist, create it.

Quick Command:

wget -O /config/scripts https://raw.githubusercontent.com/TilmanGriesel/graphite/refs/heads/main/extras/theme-patcher/graphite-theme-patcher.py

---

Step 2: Add a Shell Command

1. Open your Home Assistant configuration.yaml file.

2. Add the following entry under shell_command:

   shell_command:
     patch_graphite_theme_primary_color: "python3 /config/scripts/graphite-theme-patcher.py {{ rgb_value }}"

3. Save and restart Home Assistant.

---

Step 3: Create a Home Assistant Script

Use the Home Assistant UI or add this YAML to a new script for adjusting the theme's primary color:

alias: Update & Patch Graphite Theme
icon: mdi:palette-swatch
description: Customize the primary color of the Graphite theme.
fields:
  user_primary_color:
    selector:
      color_rgb: {}
    default:
      - 229
      - 145
      - 9
    name: Primary Color
    required: true
sequence:
  - action: shell_command.patch_graphite_theme_primary_color
    data:
      rgb_value: "{{ user_primary_color | join(',') }}"
  - action: frontend.reload_themes
    data: {}

Usage

1. Open the script in Home Assistant.
2. Choose your desired color using the color picker or input RGB values.
3. Run the script to:
   1. Apply your chosen color.
   2. Reload the Graphite theme for immediate updates.

INFO

Review the script's functionality to ensure safe usage. While safeguards are in place, it's good practice to understand any changes being applied.

Advanced Customization

The basic installation outlined earlier will likely meet your needs, so you can stop here if you're satisfied. However, if you're ready to explore the patcher's true potential, consider this your gateway to experimentation and powerful customization. The documentation isn't exhaustive, but it equips you with enough knowledge to dive deep, experimenting with RGB and size tokens to unleash their full power. From here on, you're stepping into experimental, uncharted territory.

Advanced Shell Command Example

Add a new shell command to your configuration.yaml:

shell_command:
  patch_theme: "python3 /config/scripts/graphite-theme-patcher.py --theme {{ theme }} --token {{ token }} --type {{ type }} {{ token_value }}"

Save and restart Home Assistant.

---

Advanced Script Example

alias: Update & Patch Graphite Theme (Advanced)
icon: mdi:dev-to
description: Advanced customization of Graphite theme tokens.
fields:
  user_primary_color:
    selector:
      color_rgb: {}
    name: Primary Color
    required: true
  user_radius_large:
    selector:
      number:
        min: 0
        max: 99
        step: 3
    name: "Large Radius"
    required: true
sequence:
  - action: shell_command.patch_theme
    data:
      theme: graphite
      token: token-rgb-primary
      type: rgb
      token_value: "{{ user_primary_color | join(',') }}"
  - action: shell_command.patch_theme
    data:
      theme: graphite
      token: token-size-radius-large
      type: radius
      token_value: "{{ user_radius_large }}"
  - action: frontend.reload_themes
    data: {}

Command-Line Usage

Run the patcher directly for quick edits:

python3 graphite-theme-patcher.py "255,158,0"

Options

usage: graphite-theme-patcher.py [-h] [--version] [--token TOKEN] [--type {rgb,size,opacity,radius,generic}] [--theme THEME]
                                 [--path PATH]
                                 [value]

positional arguments:
  value                 Value to set or 'None' to skip

options:
  -h, --help            show this help message and exit
  --version             Show version information and exit
  --token TOKEN         Token to update (default: token-rgb-primary)
  --type {rgb,size,opacity,radius,generic}
                        Type of token (default: rgb)
  --theme THEME         Theme name (default: graphite)
  --path PATH           Base path for themes directory (default: /config/themes)

---

• Basic Example: Update the primary color:

  python3 graphite-theme-patcher.py "0,230,226"

• Advanced Example: Modify specific tokens:

  python3 graphite-theme-patcher.py "255,158,0" --token "token-color-feedback-info"

Requirements

• Access to /config/themes/graphite.
• Write permissions for YAML files.
• Valid input values (e.g., RGB values between 0–255).

Error Handling

• Invalid Inputs: Triggers validation errors.
• Missing Tokens: Logs errors but continues execution.
• Failed Updates: Logged in logs/graphite_theme_patcher.log.