Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion .github/ABOUT.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ folder it did not touch.
| nextpad-plus-plus: Validate themes and apply script | `editors/nextpad-plus-plus/` changed | Every theme parses and meets its contrast floor with Geist Mono and the apply script passes ShellCheck |
| vivado: Validate themes and apply scripts | `editors/vivado/` changed | Every theme holds the editor colours and the 21 syntax styles in Vivado's formats and meets its contrast floor, the Linux script passes ShellCheck and the PowerShell script parses |
| notepad-plus-plus: Validate themes and apply script | `editors/notepad-plus-plus/` changed | Every theme is well formed with Geist Mono and valid colours and the PowerShell script parses |
| thonny: Validate themes and apply scripts | `editors/thonny/` changed | The plugin defines all eight themes, every platform's settings name a theme and Geist Mono, the shell scripts pass ShellCheck and the PowerShell script parses |
| thonny: Validate themes and apply scripts | `editors/thonny/` changed | The plugin defines all ten themes, every platform's settings name a theme and Geist Mono, the shell scripts pass ShellCheck and the PowerShell script parses |
| matlab: Validate themes and apply scripts | `editors/matlab/` changed | Every theme names a desktop theme and RGB colours, every platform names Geist Mono, the shell scripts pass ShellCheck and the PowerShell script parses |
| ltspice: Validate themes and apply scripts | `editors/ltspice/` changed | Every theme sets the same colour entries with 24-bit values, the shell scripts pass ShellCheck and the PowerShell script parses |
| proteus: Validate themes and apply scripts | `editors/proteus/` changed | Every theme has a short unique set name, valid PCB values and the default template's schematic slots and the PowerShell scripts parse |
Expand Down
6 changes: 6 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ body:
- terminal/terminal
- terminal/tmux
- terminal/btop
- terminal/nano
- terminal/cli-tools
- git/gitconfig
- git/git-hooks
Expand All @@ -48,10 +49,15 @@ body:
- editors/matlab
- editors/ltspice
- editors/proteus
- editors/nano
- apps/raycast
- apps/rectangle
- apps/obsidian
- apps/zotero
- apps/onedrive
- apps/zacess-scenes
- apps/zacess-games
- apps/translucenttb
- The repository as a whole (README, CI, templates)
validations:
required: true
Expand Down
6 changes: 6 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ body:
- terminal/terminal
- terminal/tmux
- terminal/btop
- terminal/nano
- terminal/cli-tools
- git/gitconfig
- git/git-hooks
Expand All @@ -48,10 +49,15 @@ body:
- editors/matlab
- editors/ltspice
- editors/proteus
- editors/nano
- apps/raycast
- apps/rectangle
- apps/obsidian
- apps/zotero
- apps/onedrive
- apps/zacess-scenes
- apps/zacess-games
- apps/translucenttb
- The repository as a whole (README, CI, templates)
validations:
required: true
Expand Down
6 changes: 6 additions & 0 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ A short, clear description of the change in your own words.
- [ ] `terminal/terminal/`
- [ ] `terminal/tmux/`
- [ ] `terminal/btop/`
- [ ] `terminal/nano/`
- [ ] `terminal/cli-tools/`
- [ ] `git/gitconfig/`
- [ ] `git/git-hooks/`
Expand All @@ -34,10 +35,15 @@ A short, clear description of the change in your own words.
- [ ] `editors/matlab/`
- [ ] `editors/ltspice/`
- [ ] `editors/proteus/`
- [ ] `editors/nano/`
- [ ] `apps/raycast/`
- [ ] `apps/rectangle/`
- [ ] `apps/obsidian/`
- [ ] `apps/zotero/`
- [ ] `apps/onedrive/`
- [ ] `apps/zacess-scenes/`
- [ ] `apps/zacess-games/`
- [ ] `apps/translucenttb/`
- [ ] The repository root or `.github/`

If a change applies to macOS, Linux and Windows, confirm all three copies were updated, not just one.
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -1265,8 +1265,8 @@ jobs:
print(f"::error file={path}::the root is not a dictionary")
bad = 1
print(f"theme/: {len(themes)} classic themes parse")
if len(themes) != 8:
print(f"::error::expected 8 .xccolortheme files, found {len(themes)}")
if len(themes) != 10:
print(f"::error::expected 10 .xccolortheme files, found {len(themes)}")
bad = 1
for path in sorted(glob.glob("theme/*.xcworkspacecolortheme")):
json.load(open(path))
Expand Down
7 changes: 6 additions & 1 deletion ACCESSIBILITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ tiring to type.

Every folder in this repository follows the same rules:

- **One set of themes everywhere.** Terminals, editors and IDEs all use the eight Zacess themes,
- **One set of themes everywhere.** Terminals, editors and IDEs all use the same Zacess themes,
with Zacess Deep Contrast Dark as the default, so switching tools never changes how the screen
reads. `zt` in the [shell](shell/README.md) switches every installed tool at once.
- **Colour is never the only signal.** Status, errors and warnings carry words as well as colour.
Expand All @@ -37,6 +37,7 @@ Each folder says exactly what it changes and what it cannot change yet.
| defaults | [setup/defaults/ACCESSIBILITY.md](setup/defaults/ACCESSIBILITY.md) |
| terminal | [terminal/terminal/ACCESSIBILITY.md](terminal/terminal/ACCESSIBILITY.md) |
| tmux | [terminal/tmux/ACCESSIBILITY.md](terminal/tmux/ACCESSIBILITY.md) |
| btop | [terminal/btop/ACCESSIBILITY.md](terminal/btop/ACCESSIBILITY.md) |
| cli-tools | [terminal/cli-tools/ACCESSIBILITY.md](terminal/cli-tools/ACCESSIBILITY.md) |
| vscode | [editors/vscode/ACCESSIBILITY.md](editors/vscode/ACCESSIBILITY.md) |
| zed | [editors/zed/ACCESSIBILITY.md](editors/zed/ACCESSIBILITY.md) |
Expand All @@ -56,10 +57,14 @@ Each folder says exactly what it changes and what it cannot change yet.
| matlab | [editors/matlab/ACCESSIBILITY.md](editors/matlab/ACCESSIBILITY.md) |
| ltspice | [editors/ltspice/ACCESSIBILITY.md](editors/ltspice/ACCESSIBILITY.md) |
| proteus | [editors/proteus/ACCESSIBILITY.md](editors/proteus/ACCESSIBILITY.md) |
| nano | [editors/nano/ACCESSIBILITY.md](editors/nano/ACCESSIBILITY.md) |
| raycast | [apps/raycast/ACCESSIBILITY.md](apps/raycast/ACCESSIBILITY.md) |
| rectangle | [apps/rectangle/ACCESSIBILITY.md](apps/rectangle/ACCESSIBILITY.md) |
| obsidian | [apps/obsidian/ACCESSIBILITY.md](apps/obsidian/ACCESSIBILITY.md) |
| zotero | [apps/zotero/ACCESSIBILITY.md](apps/zotero/ACCESSIBILITY.md) |
| onedrive | [apps/onedrive/ACCESSIBILITY.md](apps/onedrive/ACCESSIBILITY.md) |
| zacess-scenes | [apps/zacess-scenes/ACCESSIBILITY.md](apps/zacess-scenes/ACCESSIBILITY.md) |
| zacess-games | [apps/zacess-games/ACCESSIBILITY.md](apps/zacess-games/ACCESSIBILITY.md) |
| translucenttb | [apps/translucenttb/ACCESSIBILITY.md](apps/translucenttb/ACCESSIBILITY.md) |

The gitconfig, git-hooks and ssh folders change nothing about how anything looks or is operated, so
Expand Down
12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,18 @@ A patch step for fixes, a minor step for additions and a major step when the lay

## [Unreleased]

## [2.11.0] - 2026-11-08

### Added

- Eight custom Zacess Scenes in `apps/zacess-scenes/scenes`, drawn as Lua pixel scenes with scrolling captions: hello-isaac, now-building, lidarsat, scope, phaemos, build-passed, build-failed and football, where BUILD FC scores when the build passes and the shot hits the post or lands in the keeper's hands when it fails. The setup scripts link them into the scenes folder on every machine. `scenes.toml` plays the new pass scenes (rocket launch, pit stop, PCB bring-up, drone landing, kettle boil) and fail scenes (launch scrub, stuck pit stop, dead LED, landing abort, cold kettle) alongside the custom ones.
- Zacess Warm Dark and Zacess Warm Light, the gentler pair held to WCAG AA (4.5:1), join the eight themes, so `zt warm-dark`, `zt warm-light` and `termtheme warm-dark` work on macOS, Linux, WSL and Windows. The terminal palette takes both from Zacess Themes and `build-themes.py` writes them for Terminal.app, iTerm2, Ghostty, Kitty, Alacritty, Windows Terminal, Ptyxis, GNOME Terminal, tmux, btop and nano, measuring each theme against its own text floor. KiCad, Processing, Vivado, Nextpad++, Notepad++, LTspice, MATLAB, Microchip Studio, Proteus, Thonny, Eclipse, STM32CubeIDE, Zed and Zotero carry both themes. Every apply script accepts the two short names. VS Code, Arduino IDE, the JetBrains IDEs, Neovim, Obsidian and Xcode take them once their packages move to the Zacess Themes release that ships them.

### Changed

- Every theme pin moves to Zacess Themes 1.0.0, the release that brings Zacess Warm Dark and Zacess Warm Light into every store and package. The JetBrains, Arduino IDE, Zed and Obsidian packages take their new digests, along with the VS Code extension list, zacess.nvim and the terminal palette version. The Arduino package lists all ten themes and the Obsidian package installs a fifth theme, Zacess Warm, which `themes.json` maps to the two warm looks. The Zed theme file and the Eclipse themes are copied from the release again. The Nextpad++, KiCad, Processing and Vivado builds read the 1.0.0 palette by its digest. The STM32CubeIDE, MATLAB, Proteus, Thonny, LTspice, Microchip Studio and Notepad++ themes are rebuilt from the release. The Arduino and Obsidian checks now expect ten themes. The Processing and Vivado checks hold syntax on the current line to 4.5:1, the rule Zacess Themes 0.6.0 sets, in place of 7:1.
- The demo screenshots and clips for the macOS and Linux shell, lazygit, fzf, the terminal, tmux, Neovim and the git hooks are recorded again from the current setup. The shell, lazygit, fzf and git hook scenes gain Warm Dark and Warm Light versions. A new shot of the whole setup in one tmux session, with Neovim across the top and a shell, btop and a Zacess Scenes scene along the bottom, heads the root README and the tmux README. Two more shots in the same layout show a build that passes and one that fails, with Zacess Scenes watch mode beside each: the garden under its ALL GOOD banner and the storm under its FAILED banner with the error lines. They sit side by side below the main shot in the root README. All three are recorded in Deep Contrast Light as well and the READMEs show the light or dark shot to match the system theme.

### Fixed

- Starship no longer prints `Executing command ... timed out` on a slow first prompt: `command_timeout` is 2000 ms on macOS, Linux and Windows, up from the 500 ms default.
Expand Down
2 changes: 1 addition & 1 deletion NOTICE.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ the list of style names and slots is followed.

| Material | Where it is used | Credit |
| --- | --- | --- |
| Zacess Themes | The eight colour themes in every terminal, editor and IDE folder. The KiCad, Processing, Nextpad++, Vivado, Notepad++, Thonny, MATLAB, LTspice, Proteus and Microchip Studio themes are built from its palette. Zed's theme file in `editors/zed/shared/themes` is the one Zacess Themes 0.5.0 ships for Zed, copied as released. The JetBrains IDEs get the Zacess Themes plugin from the JetBrains Marketplace. When an IDE's launcher cannot be found they get it from a pinned release checked against its digest | [zacesshq/themes](https://github.com/zacesshq/themes) |
| Zacess Themes | The colour themes in every terminal, editor and IDE folder. The KiCad, Processing, Nextpad++, Vivado, Notepad++, Thonny, MATLAB, LTspice, Proteus and Microchip Studio themes are built from its palette. Zed's theme file in `editors/zed/shared/themes` is the one Zacess Themes 1.0.0 ships for Zed, copied as released. The JetBrains IDEs get the Zacess Themes plugin from the JetBrains Marketplace. When an IDE's launcher cannot be found they get it from a pinned release checked against its digest | [zacesshq/themes](https://github.com/zacesshq/themes) |
| Geist Mono and Nerd Fonts | The terminal and editor font; the Windows bootstrap downloads the Nerd Fonts build of Geist Mono | [Geist](https://github.com/vercel/geist-font) by Vercel and [Nerd Fonts](https://github.com/ryanoasis/nerd-fonts), both under the SIL Open Font License |
| Starship | The prompt in the [shell](shell) folder | [starship/starship](https://github.com/starship/starship) |
| zsh-syntax-highlighting | Typed-command colours in the zsh profiles | [zsh-users/zsh-syntax-highlighting](https://github.com/zsh-users/zsh-syntax-highlighting) |
Expand Down
15 changes: 12 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,15 @@
[![CI](https://github.com/zaccesss/dotfiles/actions/workflows/ci.yml/badge.svg)](https://github.com/zaccesss/dotfiles/actions/workflows/ci.yml)
[![Licence: MIT](https://img.shields.io/badge/licence-MIT-green.svg)](LICENSE)

<a href="terminal/tmux/docs/demo/hero-dark.gif"><picture><source media="(prefers-color-scheme: light)" srcset="terminal/tmux/docs/demo/hero-light.png"><source media="(prefers-color-scheme: dark)" srcset="terminal/tmux/docs/demo/hero-dark.png"><img src="terminal/tmux/docs/demo/hero-dark.png" alt="A tmux session in Zacess Deep Contrast, dark or light to match the system theme. Neovim runs across the top, its file tree listing the Zacess Scenes Lua files beside build-passed.lua open in the editor. Along the bottom, from left to right: a shell showing a five-line git log and a build that passed, btop with CPU load and network traffic, then the harbour scene from Zacess Scenes playing in the same theme"></picture></a>

<table>
<tr>
<td width="50%"><a href="terminal/tmux/docs/demo/hero-pass-dark.gif"><picture><source media="(prefers-color-scheme: light)" srcset="terminal/tmux/docs/demo/hero-pass-light.png"><source media="(prefers-color-scheme: dark)" srcset="terminal/tmux/docs/demo/hero-pass-dark.png"><img src="terminal/tmux/docs/demo/hero-pass-dark.png" alt="A passing build in the same tmux layout: Neovim with build-passed.lua across the top, a shell where python3 -m compileall finishes and prints build passed, then btop. Zacess Scenes watch mode fills the last pane with the garden scene under a large ALL GOOD banner, a check mark and the caption &quot;Everything is growing nicely.&quot;"></picture></a><br>A passing build</td>
<td width="50%"><a href="terminal/tmux/docs/demo/hero-fail-dark.gif"><picture><source media="(prefers-color-scheme: light)" srcset="terminal/tmux/docs/demo/hero-fail-light.png"><source media="(prefers-color-scheme: dark)" srcset="terminal/tmux/docs/demo/hero-fail-dark.png"><img src="terminal/tmux/docs/demo/hero-fail-dark.png" alt="A failing build in the same tmux layout: Neovim with build-failed.lua across the top, a shell where git status lists a new report.py and python3 -m compileall stops on SyntaxError: expected ':' before printing build failed, then btop. Zacess Scenes watch mode fills the last pane with the storm scene under a large FAILED banner with a cross, the caption &quot;Something broke. The storm will pass.&quot; and the two error lines"></picture></a><br>A failing build</td>
</tr>
</table>

---

## What this is
Expand All @@ -16,7 +25,7 @@ machine up, the shell profile and its aliases, the terminal and its tools, Git a
and IDE and the few desktop apps I drive from the keyboard.

I have monocular vision, so distinct, high-contrast colours do real work for me rather than being a
matter of taste. Every folder uses the same eight Zacess themes, with Zacess Deep Contrast Dark as
matter of taste. Every folder uses the same Zacess themes, with Zacess Deep Contrast Dark as
the default, so moving between a terminal, an editor and an IDE never changes how the screen reads.
The [accessibility statement](ACCESSIBILITY.md) says what that means in practice.

Expand Down Expand Up @@ -65,8 +74,8 @@ To use one tool on its own, open its folder below and follow its setup guide.
| [shell](shell/README.md) | The zsh, bash and PowerShell profiles with their aliases and helpers, the Starship prompt, the Command Prompt start-up and the `zt` theme switcher |
| [terminal](terminal/README.md) | The Zacess terminal themes, tmux and the everyday command line tools |
| [git](git/README.md) | The gitconfig, the Git hooks and the SSH client config |
| [editors](editors/README.md) | VS Code, Zed, the JetBrains IDEs, Eclipse, STM32CubeIDE, Xcode, Neovim, Arduino IDE, Microchip Studio, KiCad, Vivado, Processing, Notepad++, Nextpad++, Thonny, MATLAB, LTspice and Proteus |
| [apps](apps/README.md) | Raycast and Rectangle on the Mac, Obsidian and Zotero everywhere and TranslucentTB on Windows |
| [editors](editors/README.md) | VS Code, Zed, the JetBrains IDEs, Eclipse, STM32CubeIDE, Xcode, Neovim, Arduino IDE, Microchip Studio, KiCad, Vivado, Processing, Notepad++, Nextpad++, nano, Thonny, MATLAB, LTspice and Proteus |
| [apps](apps/README.md) | Raycast and Rectangle on the Mac, Obsidian, Zotero, Zacess Scenes with eight custom Lua scenes and Zacess Games everywhere, OneDrive on Linux and TranslucentTB on Windows |

How the repository is checked and maintained (every workflow, issue form and template) is in
[.github/ABOUT.md](.github/ABOUT.md).
Expand Down
2 changes: 1 addition & 1 deletion apps/obsidian/ACCESSIBILITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ The same high contrast theme on every machine, set once in the vault.

## Vision

- The default is Zacess Deep Contrast Dark: the Zacess Deep Contrast theme with Obsidian's dark base colour scheme. All eight Zacess looks are available, light ones included: the four Zacess themes are installed and each carries a light and a dark look, chosen under **Settings > Appearance**. Measured contrast is in the [Zacess Themes accessibility statement](https://github.com/zacesshq/themes/blob/main/ACCESSIBILITY.md).
- The default is Zacess Deep Contrast Dark: the Zacess Deep Contrast theme with Obsidian's dark base colour scheme. All ten Zacess looks are available, light ones included: the four Zacess themes are installed and each carries a light and a dark look, chosen under **Settings > Appearance**. Measured contrast is in the [Zacess Themes accessibility statement](https://github.com/zacesshq/themes/blob/main/ACCESSIBILITY.md).
- Code blocks and inline code use GeistMono Nerd Font, the font every editor uses.
- Links are underlined as well as coloured in the Zacess themes. The active tab, the open file and a selected row carry a bar, so colour is never the only signal.

Expand Down
4 changes: 2 additions & 2 deletions apps/obsidian/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Obsidian setup: the four Zacess community themes installed in a vault, the chose
| `.obsidian/appearance.json` | `cssTheme` (the theme that carries the chosen look), `theme` (its dark `obsidian` or light `moonstone` half) and `monospaceFontFamily` GeistMono Nerd Font | Each Zacess theme follows Obsidian's own base colour scheme between its light and dark look, so no plugin is needed |
| This machine's `obsidian.json` | The vault marked as the one that opens | Obsidian starts in that vault |

In a synced vault the `.obsidian` folder travels with it, so the themes and the look are shared by every machine that opens it. `obsidian.json` is each machine's own. [`shared/themes.json`](shared/themes.json) maps each of the eight looks to its theme and base colour scheme: Zacess Deep Contrast Dark is `Zacess Deep Contrast` plus `obsidian`, Zacess Cream is `Zacess Cream` plus `moonstone`, Zacess Yellow on Black is `Zacess Cream` plus `obsidian` and so on.
In a synced vault the `.obsidian` folder travels with it, so the themes and the look are shared by every machine that opens it. `obsidian.json` is each machine's own. [`shared/themes.json`](shared/themes.json) maps each of the ten looks to its theme and base colour scheme: Zacess Deep Contrast Dark is `Zacess Deep Contrast` plus `obsidian`, Zacess Cream is `Zacess Cream` plus `moonstone`, Zacess Yellow on Black is `Zacess Cream` plus `obsidian` and so on.

## Apply

Expand Down Expand Up @@ -46,4 +46,4 @@ The vault list is `~/Library/Application Support/obsidian/obsidian.json` on macO

## Validation

[`scripts/validate.py`](scripts/validate.py) runs in CI on Linux. It checks all eight looks map to an installed theme and a base colour scheme, every theme package pins a release zip with a full digest and the appearance settings name Geist Mono.
[`scripts/validate.py`](scripts/validate.py) runs in CI on Linux. It checks all ten looks map to an installed theme and a base colour scheme, every theme package pins a release zip with a full digest and the appearance settings name Geist Mono.
Loading
Loading