# Darwin Breeze

Breeze for KDE Plasma 6 in the macOS dark system colors, with Helium, T3 Code,
VS Code and Telegram themed from the same colors.

Only the colors change. Breeze still draws the widgets and the title bar, and
the window buttons stay on the right.

- Selection and focus rings use the macOS blue, `#007AFF`.
- The title bar has the same color as the toolbar below it, so the two read as
  one strip.
- When a window loses focus, its selection turns gray, as on macOS.
- Errors, warnings, success text and links use Apple's system red, orange,
  green, blue and purple.

## Install

From `~/.dotfiles`:

```sh
stow -d kde -t "$HOME" theme
./kde/theme/apply.sh
```

`apply.sh` regenerates the app themes, applies the global theme, hides the
line under the title bar, turns off the wallpaper accent color, gives Helium
the KWin title buttons and an even tab strip, publishes the T3 Code theme and
installs the VS Code extension. Restart Helium afterwards; T3 Code switches on its own. In VS
Code, pick "Darwin Breeze Dark" once under Preferences → Color Theme; after
later color changes, run Developer: Reload Window.

Telegram has to import its theme by hand: Settings → Chat Settings → Chat
background → Choose from file, then pick
`kde/theme/telegram/DarwinBreezeDark.tdesktop-theme` and Apply. Import it
again after the colors change.

## Changing colors

The color scheme is the only place colors are defined:

```
kde/theme/.local/share/color-schemes/DarwinBreezeDark.colors
```

Edit it, then run `./kde/theme/apply.sh` again. Everything else follows:

| App                               | How it gets the colors                                                                                                            |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Qt / KDE apps                     | the color scheme itself                                                                                                           |
| GTK apps                          | Breeze GTK, which `kde-gtk-config` syncs from the scheme                                                                          |
| Tray icons in `kde/tray-icons/`   | `ColorScheme-Text`, recolored by Plasma                                                                                           |
| Helium                            | Breeze GTK, through Helium's GTK theme (see [Helium notes](#helium-notes))                                                        |
| T3 Code                           | `t3/darwin-breeze.json`, generated by `build.py` and published with `t3 theme set`                                                |
| VS Code                           | `vscode/package.json` and `vscode/themes/`, generated by `build.py`, packed into `darwin-breeze.vsix` and installed by `apply.sh` |
| Telegram                          | `telegram/DarwinBreezeDark.tdesktop-theme`, built by `build.py` and imported by hand                                              |

The generated text files are committed so that `stow` alone gives a working
setup; the binary packages (Telegram's `.tdesktop-theme`, VS Code's `.vsix`)
are built by `build.py` instead. Don't edit generated files by hand.

## T3 Code notes

- T3 Code ignores symlinked theme files, so the theme isn't stowed;
  `apply.sh` publishes a copy into `~/.t3/userdata/themes/`.
- Every slot of the T3 theme maps to a role in the color scheme (see `t3()` in
  `build.py`), so a new slot or a different mapping is a change there, not a
  hand-edited color.

## VS Code notes

- The workbench colors start from VS Code's own default dark theme, Dark 2026
  (vendored in `vscode/base/` with the themes it includes). It already lays
  out its grays as the scheme does: the editor darkest, the chrome around it
  lighter, widgets lighter still. Each of those becomes the matching scheme
  gray and the grays between them are interpolated. Other colors take the
  hue of the matching Apple color and keep their lightness and saturation.
  Keys with an exact role, such as buttons, badges, the active tab's top
  border and the git colors, are set directly (`vscode()` in `build.py`).
- Syntax colors are Pierre Dark's, the theme T3 Code highlights code with
  (`vscode/base/pierre-dark.json`, taken from T3 Code). They are used as they
  are, without gamma compensation, so code looks the same in both apps.
- The terminal palette is generated from the color scheme.
- VS Code is Electron, so its workbench colors get the same gamma
  compensation as T3 Code.
- The `.vsix` isn't committed; `build.py` packs it from `vscode/`.

## Telegram notes

- Telegram has some 600 color keys and the scheme has roles for only a few
  dozen of them (`telegram()` in `build.py`). The rest start from Telegram's
  own night theme, vendored as `telegram/night.tdesktop-palette`: its
  blue-tinted grays become scheme grays of the same brightness and its blues
  take the macOS blue's hue. Other colors, such as the reds, greens and name
  colors, are kept as night has them.
- The chat list, top bar and compose bar use the window color; the chat
  behind the bubbles and the folder strip use the darker view color.
- Telegram is a Qt app, so unlike T3 Code and VS Code it needs no gamma
  compensation.
- The `.tdesktop-theme` is a zip, so it isn't committed; `build.py` builds it
  from the night palette and the color scheme.

## Helium notes

- Helium uses the GTK theme (Settings → Appearance → Theme: GTK) with "Use
  system title bar and borders" off, so the tab strip doubles as the title
  bar. Its colors come from Breeze GTK, which `kde-gtk-config` syncs from
  the scheme; there is no Helium theme to generate.
- With the system title bar off, Helium draws the window buttons through
  GTK. `kde-gtk-config` renders the KWin buttons into
  `~/.config/gtk-3.0/window_decorations.css`, but hands that file to GTK apps
  through a GTK module that Helium doesn't load, so Helium would show Breeze
  GTK's own round buttons instead. `apply.sh` imports the file from `gtk.css`
  so Helium picks it up too.
- In the compact layout, the address bar takes GTK's text field color and the
  segment with the extension and window buttons takes the window color, which
  Chromium resolves to the darker view color. `.config/gtk-3.0/chromium.css`
  gives both the title bar color, and `apply.sh` imports it from `gtk.css`.
  Chromium adds a `chromium` class to every GTK node it reads colors from, so
  the rules reach Helium and no other GTK app.
- Chromium tags its output as sRGB and KWin shows it with a gamma 2.2 curve,
  which lifts dark grays (40 becomes 44). T3 Code and VS Code get
  pre-compensated colors from `build.py`; Helium instead runs with
  `--disable-features=WaylandWpColorManagerV1`, so its surfaces go untagged
  and show the GTK colors as they are.

## When the colors don't show up

- In System Settings → Colors, take the accent color from the color scheme. A
  custom accent, or one taken from the wallpaper, replaces the blue.
- Use the Plasma style called "Breeze". "Breeze Dark" and "Breeze Light" carry
  their own colors, so panels and popups ignore the scheme.
- GTK apps follow the scheme only with the Breeze GTK theme. Flatpak apps also
  need `org.gtk.Gtk3theme.Breeze` installed.