Files
omarchy-ash-theme/README.md
T

103 lines
3.8 KiB
Markdown

# 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 .`.
## Screenshots
Both variants in action on a running desktop:
| Ash Dark | Ash Light |
|----------|-----------|
| ![Ash Dark screenshot](images/screenshots/screenshot-ash-dark.png) | ![Ash Light screenshot](images/screenshots/screenshot-ash-light.png) |
## 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
```
See **[tools/ash-wallpaper.md](tools/ash-wallpaper.md)** for the full
parameter guide, hue reference of the Ash palette and ready-made recipes
(sunsets, night cities, portraits, near-monochrome).
## 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).