# Ash — Omarchy themes (light & dark)

**Ash** is a warm-neutral palette — Gruvbox hues cooled and desaturated toward
a grey / ash look: bone text on soot panels, ember accents (light variant: ink
on ash-paper). It is the same 16-colour palette used by the *Ash* themes for
TriliumNext and by the AshPalette in the HAIYUKI project.

The theme set is derived from the excellent
[Harbor](https://github.com/HANCORE-linux/omarchy-harbor-theme) /
[Harbor Dark](https://github.com/HANCORE-linux/omarchy-harbordark-theme)
Omarchy themes (MIT, © HANCORE): every config file was recolored from the
Harbor palette to Ash.

## Variants

### Ash Dark

![Ash Dark palette](images/ash-dark-palette.png)

### Ash Light

![Ash Light palette](images/ash-light-palette.png)

| Theme dir  | Style | Base surfaces                    | Accent |
|------------|-------|----------------------------------|--------|
| `ash-dark` | dark  | void `#100f12`, panel `#1c1b1f`, raised `#29282c`, bone `#e6dfd1` | ember `#e0914f` |
| `ash-light`| light | paper `#e9e3d5` / ink `#2a2822` · raised `#f2ecdf`, deep `#dcd5c3` | ember `#a85f1d` |

Accents: ember, gold, blood, rot, moss, steel, violet, rust (see
`tools/recolor.py` for the exact terminal 16-colour mapping).
Regenerate the swatch images above with `python3 tools/make_palette_images.py .`.

## Install (local)

Copy or symlink the variant folders into the user themes directory — the
folder name is what appears in the theme menu:

```sh
mkdir -p ~/.config/omarchy/themes
cp -r ash-light ash-dark ~/.config/omarchy/themes/
# then: Super+Space > Style > Theme > ash-light / ash-dark
# or:   omarchy-theme-set ash-dark
```

Note: Omarchy distinguishes hand-written themes from installed ones by the
presence of a `.git` directory inside the theme folder. When installing this
repo via `omarchy-theme-install`, terminal configs (alacritty/foot/ghostty/
kitty) and `vscode.json` would be dropped by the filter — so use the
copy/symlink method above for your own machine.

## Backgrounds

No wallpapers are shipped (Harbor's don't match the palette). Drop images into
`~/.config/omarchy/themes/ash-dark/backgrounds/` and cycle with
`Super+Ctrl+Space`, or keep them in `~/.config/omarchy/backgrounds/ash-dark/`.

### Generating Ash wallpapers from your own photos

`tools/ash-wallpaper.sh` (ImageMagick) turns any color photo into an Ash
wallpaper: the image is reduced to Ash-tinted greys, while warm ember/gold
highlights (sunset, fire, lights, skin tones) are selectively preserved.

```sh
tools/ash-wallpaper.sh photo.jpg                 # -> photo-ash.png, dark base
PRESET=light tools/ash-wallpaper.sh photo.jpg    # light variant base
```

Tuning via environment variables: `HUE_MAX`/`HUE_MIN` (width of the warm hue
band), `SAT_MIN`/`SAT_MAX` (how colourful a pixel must be to survive),
`EMBER_BOOST` (saturation of highlights), `BASE_LO`/`BASE_HI` (grey ramp).

## Regenerating from the palette

The files in `ash-light/` and `ash-dark/` are generated from
`tools/reference/` (the Harbor text files) by `tools/recolor.py`, which applies
an explicit Harbor→Ash color map plus a nearest-color fallback and renames the
branding. If the Ash palette changes (e.g. new Trilium CSS), update the maps in
`tools/recolor.py` and run:

```sh
python3 tools/recolor.py .
```

## Included apps

Everything Harbor themes covered: terminal (colors.toml + alacritty/ghostty/
kitty for the light variant), waybar, walker, mako, swayosd, hyprland,
hyprlock, btop, cava, superfile, fzf, fish, zed, vscode (+ extension in
`vscode-extension/`), chromium, steam, vencord, zen, warp (light), plus
`icons.theme` (Yaru / Yaru-dark) and a `light.mode` marker for the light
variant.

## License

MIT (upstream Harbor license retained).