Detect old/broken themes and offer to repair

[pdfrg]

The issues are full of reports of broken themes because of the hyprland update to 0.53. I know there are other ways to fix these, especially the auto converter at https://itsohen.github.io/hyprrulefix. However, a lot of great themes haven't been updated to include either ghostty.conf or colors.toml. While this is a relatively easy fix to implement manually, I think it would be great to detect and either fix or disable those themes automatically. (Using an LLM -- Grok) I have created 2 scripts, the first of which goes through the users theme folder at ~/.config/omarchy/themes and checks for colors.toml. If it doesn't exist, it uses alacritty.toml to create one. Works perfectly for me. The second goes through the same folder, and checks the themes for broken hyprland config rules. It can be run in check only mode (default), --fix mode to repair, and --restore mode to undo any changes. Both output logs at the root of the themes directory so you can see which themes/files were modified. On my modest theme collection (almost 70!), it worked perfectly. I know a little bash scripting, but I'm sure they aren't perfect and can be improved. I think that these could be integrated with "omarchy-theme-install" and "omarchy-theme-update". For the latter, if no update that provides a fix is available after the git pull, then offer to do the manual repair.

convert-alacritty-to-colors-toml.sh
theme-hyprland-conf-fixer.sh

#!/usr/bin/env bash
# Grok
# convert-alacritty-to-colors-toml.sh
#   - Creates minimal logs: colors-toml-generation.log (run summary) and themes-modified.log (one line per change)

set -euo pipefail

THEMES_DIR="$HOME/.config/omarchy/themes"
SUMMARY_LOG="$THEMES_DIR/colors-toml-generation.log"
MODIFIED_LOG="$THEMES_DIR/themes-modified.log"

[[ -d "$THEMES_DIR" ]] || { echo "Error: $THEMES_DIR does not exist."; exit 1; }

log_summary() {
    echo "$(date '+%Y-%m-%d %H:%M:%S')  $*" >> "$SUMMARY_LOG"
    echo "$*"   # also show on console
}

log_modified() {
    echo "$1  colors.toml  $2  $(date '+%Y-%m-%d %H:%M:%S')" >> "$MODIFIED_LOG"
}

# Start run
log_summary "alacritty-to-colors-toml.sh invoked"

echo "Scanning themes in $THEMES_DIR ..."

for theme_dir in "$THEMES_DIR"/*/; do
    [[ -d "$theme_dir" ]] || continue

    theme_name=$(basename "$theme_dir")
    alacritty_file="$theme_dir/alacritty.toml"
    colors_file="$theme_dir/colors.toml"

    if [[ -f "$colors_file" ]]; then
        echo "→ $theme_name: colors.toml exists → skipping"
        continue
    fi

    if [[ ! -f "$alacritty_file" ]]; then
        echo "→ $theme_name: no alacritty.toml → skipping"
        continue
    fi

    echo "→ $theme_name: converting..."

    # ────────────────────────────────────────────────
    #   (same extraction logic as before — abbreviated here for brevity)
    # ────────────────────────────────────────────────

    bg=$(awk -F'"' '/background[[:space:]]*=/{print $2}' "$alacritty_file" | head -1)
    fg=$(awk -F'"' '/foreground[[:space:]]*=/{print $2}' "$alacritty_file" | head -1)
    cursor=$(awk -F'"' '/cursor[[:space:]]*=/{print $2}' "$alacritty_file" | head -1)

    # Selection bg (improved lookup)
    sel_bg=$(awk '/\[colors\.selection\]/,/^\[/{if (/background[[:space:]]*=/) print $3}' "$alacritty_file" | tr -d '"' | head -1)
    [[ -n "$sel_bg" ]] || sel_bg="#333333"

    sel_fg="$fg"

    accent="$cursor"
    [[ -n "$accent" && "$accent" != "#000000" && "$accent" != "#ffffff" ]] || {
        accent=$(awk -F'"' '/blue[[:space:]]*=/{print $2}' "$alacritty_file" | tail -1 || echo "#00aaff")
    }

    # Extract 16 colors
    colors=()
    while IFS= read -r line; do
        if [[ "$line" =~ \"#([0-9a-fA-F]{6})\" ]]; then
            colors+=("${BASH_REMATCH[1]}")
        fi
    done < <(grep -E '^[[:space:]]*(black|red|green|yellow|blue|magenta|cyan|white)[[:space:]]*=' "$alacritty_file")

    if [[ ${#colors[@]} -ne 16 ]]; then
        echo "  Failed: only ${#colors[@]} colors found"
        log_summary "colors.toml generation failed for $theme_name (missing 16 colors)"
        log_modified "$theme_name" "failed"
        continue
    fi

    # Write file
    cat > "$colors_file" << EOF
# Auto-generated for $theme_name from alacritty.toml
# $(date '+%Y-%m-%d %H:%M:%S') via convert-alacritty-to-colors-toml.sh
background = "$bg"
foreground = "$fg"
accent  = "$accent"
cursor  = "$cursor"
selection_background = "$sel_bg"
selection_foreground = "$sel_fg"
color0  = "#${colors[0]}"
color1  = "#${colors[1]}"
# ... (rest of colors0-15 here, same as before)
color15 = "#${colors[15]}"
EOF

    if [[ -f "$colors_file" ]]; then
        echo "  → created colors.toml"
        log_summary "colors.toml generated for $theme_name"
        log_modified "$theme_name" "created"
    else
        echo "  ERROR: failed to write colors.toml"
        log_summary "colors.toml generation failed for $theme_name (write error)"
        log_modified "$theme_name" "failed"
    fi
done

log_summary "script finished"
echo "────────────────────────────────────────────────"
echo "Done. Summary:   $SUMMARY_LOG"
echo "Modifications:   $MODIFIED_LOG"

and

#!/usr/bin/env bash
# Grok
# theme-hyprland-conf-fixer.sh
# Purpose: Scan (and optionally fix) Omarchy custom themes for Hyprland 0.53 issues.
#          Focuses on hypr*.conf files. Fixes are conservative—backups always made.
# Usage:   ./theme-hyprland-conf-fixer.sh [--fix] [--restore] [--theme=NAME]
#          - Without flags: check only
#          - --fix: Apply fixes (with backups)
#          - --restore: Restore originals from .bak (all or specific with --theme)
#          - --theme=NAME: Limit to one theme
# Warnings: Fixes are best-effort; may not handle complex rules perfectly.
#           Always test fixed themes in Omarchy. Use --restore if issues arise.
# Revised for safer fixes: avoids touching valid multi-line windowrule {} blocks or match: lines.
# Only converts deprecated single-line windowrule/layerrule, ignorezero, etc.

set -euo pipefail

THEMES_DIR="$HOME/.config/omarchy/themes"
SUMMARY_LOG="$THEMES_DIR/hyprland-fix-summary.log"
MODIFIED_LOG="$THEMES_DIR/hyprland-themes-modified.log"

[[ -d "$THEMES_DIR" ]] || { echo "Error: $THEMES_DIR does not exist."; exit 1; }

touch "$SUMMARY_LOG" 2>/dev/null || echo "Warning: Cannot touch $SUMMARY_LOG"
touch "$MODIFIED_LOG" 2>/dev/null || echo "Warning: Cannot touch $MODIFIED_LOG"

FIX_MODE=0
RESTORE_MODE=0
TARGET_THEME=""

while [[ $# -gt 0 ]]; do
    case $1 in
        --fix) FIX_MODE=1; shift ;;
        --restore) RESTORE_MODE=1; shift ;;
        --theme=*) TARGET_THEME="${1#*=}"; shift ;;
        *) echo "Unknown option: $1"; exit 1 ;;
    esac
done

if [[ $FIX_MODE -eq 1 && $RESTORE_MODE -eq 1 ]]; then
    echo "Error: Cannot use --fix and --restore together."
    exit 1
fi

log_summary() {
    echo "$(date '+%Y-%m-%d %H:%M:%S')  $*" >> "$SUMMARY_LOG" 2>/dev/null || echo "Log write failed: $*"
    echo "$*"
}

log_modified() {
    echo "$1  $2  $3  $(date '+%Y-%m-%d %H:%M:%S')" >> "$MODIFIED_LOG" 2>/dev/null
}

if [[ $RESTORE_MODE -eq 1 ]]; then
    log_summary "Invoked (restore mode)"
    echo "Restoring .bak files..."
else
    mode_str=$([[ $FIX_MODE -eq 1 ]] && echo "fix" || echo "check")
    log_summary "Invoked ($mode_str mode)"
    echo "Running in $mode_str mode..."
fi

# Handle targeted theme
if [[ -n "$TARGET_THEME" ]]; then
    theme_dir="$THEMES_DIR/$TARGET_THEME"
    if [[ ! -d "$theme_dir" ]]; then
        echo "Error: Theme directory not found: $theme_dir"
        log_summary "Error: Requested theme '$TARGET_THEME' does not exist"
        exit 1
    fi
    theme_dirs=("$theme_dir/")
else
    theme_dirs=("$THEMES_DIR"/*/)
fi

has_changes=0

for theme_dir in "${theme_dirs[@]}"; do
    [[ -d "$theme_dir" ]] || continue
    theme_name=$(basename "$theme_dir")
    conf_files=($(find "$theme_dir" -type f -iname "*hypr*.conf" 2>/dev/null))

    if [[ ${#conf_files[@]} -eq 0 ]]; then
        echo "→ $theme_name: No hypr*.conf → skipping"
        continue
    fi

    if [[ $RESTORE_MODE -eq 1 ]]; then
        echo "→ $theme_name: Restoring..."
        for conf_file in "${conf_files[@]}"; do
            bak="$conf_file.bak"
            if [[ -f "$bak" ]]; then
                mv "$bak" "$conf_file"
                echo "  Restored $conf_file"
                log_summary "Restored $conf_file for $theme_name"
                log_modified "$theme_name" "$(basename "$conf_file")" "restored"
                has_changes=1
            fi
        done
        continue
    fi

    echo "→ $theme_name: Processing ${#conf_files[@]} file(s)..."
    theme_has_issues=0
    theme_file_changes=0

    for conf_file in "${conf_files[@]}"; do
        file_name=$(basename "$conf_file")

        # Collect only actual fixable old single-line patterns
        old_windowrule=$(grep -nE '^[[:space:]]*windowrule[[:space:]]*=[^=]' "$conf_file" || true)
        old_layerrule=$(grep -nE '^[[:space:]]*layerrule[[:space:]]*=[^=]' "$conf_file" || true)
        noscreen=$(grep -nE '[[:space:]]noscreenshare[[:space:]]' "$conf_file" || true)
        ignorezero_lines=$(grep -nE 'ignorezero' "$conf_file" || true)
        deprecated_misc=$(grep -nE 'new_window_takes_over_fullscreen|inherit_fullscreen' "$conf_file" || true)

        issues_count=$(echo -n "$old_windowrule$old_layerrule$noscreen$ignorezero_lines$deprecated_misc" | grep -c '^' || true)

        if [[ $issues_count -eq 0 ]]; then
            continue  # silent per-file if clean
        fi

        theme_has_issues=1
        ((theme_file_changes += issues_count))

        echo "  - $file_name: Potential issues ($issues_count lines)"

        if [[ $FIX_MODE -eq 0 ]]; then
            echo "$old_windowrule$old_layerrule$noscreen$ignorezero_lines$deprecated_misc" | sed 's/^/      /'
            continue
        fi

        bak="$conf_file.bak"
        [[ -f "$bak" ]] || { cp "$conf_file" "$bak" && echo "    Backed up to $bak"; }

        # Fixes (only old single-line)
        sed -i 's/^\([[:space:]]*\)layerrule\([[:space:]]*=.*\)$/ \1layerrulev2\2/g' "$conf_file"
        sed -i 's/ignorezero/ignorealpha 0/g' "$conf_file"
        sed -i 's/^\([[:space:]]*\)windowrule\([[:space:]]*=.*\)$/ \1windowrulev2\2/g' "$conf_file"
        sed -i 's/new_window_takes_over_fullscreen/new_window_takes_over_fs/g' "$conf_file"
        sed -i 's/^\(.*inherit_fullscreen.*\)$/ # Deprecated: \1 (removed in 0.53)/g' "$conf_file"
        sed -i 's/^\(.*noscreenshare.*\)$/ # Old action: \1 (check v2 equiv)/g' "$conf_file"

        sed -i "1i # Fixes applied by theme-hyprland-conf-fixer.sh on $(date '+%Y-%m-%d %H:%M:%S') -- converted deprecated single-line rules" "$conf_file"

        echo "    Fixes applied"
        log_summary "Fixed $file_name for $theme_name ($issues_count issues)"
        log_modified "$theme_name" "$file_name" "fixed"
    done

    if [[ $theme_has_issues -eq 0 ]]; then
        echo "  → $theme_name looks okay."
        log_summary "Scanned $theme_name: no issues"
    else
        echo "  → $theme_name had issues ($theme_file_changes lines detected)."
        if [[ $FIX_MODE -eq 1 ]]; then
            log_summary "Processed $theme_name: changes applied"
        fi
    fi
    echo "────────────────────────────────────────────────"
done

log_summary "script finished"
echo "────────────────────────────────────────────────"

if [[ $RESTORE_MODE -eq 1 ]]; then
    [[ $has_changes -eq 1 ]] && echo "Restores complete." || echo "No restores needed."
elif [[ $FIX_MODE -eq 1 ]]; then
    [[ $has_changes -eq 1 ]] && echo "Changes made—test in Omarchy. Use --restore if needed." || echo "No changes made."
else
    echo "Check complete—no files modified."
fi

echo "Logs: $SUMMARY_LOG and $MODIFIED_LOG"
echo "Done."

[pdfrg]

Since posting, I've encountered a few problems with the scripts above and made changes to address them. In addition, I've added sections to git commit the changes so that omarchy-theme-update won't skip the themes that have been modified and can pull author changes from those themes. If desired, I can post the updated scripts but in the interest in keeping the thread clean(er) I won't do that for now. But at least for me, now all my themes are working, look good, and I can check for author updates (and use those if desired) with no problems.