hl-valdemar
210 lines
5.2 KiB
Markdown
210 lines
5.2 KiB
Markdown
# tint
|
|
|
|
A small wrapper around [Tinty](https://github.com/tinted-theming/tinty) that manages light/dark theme pairs and applies the selected theme to Ghostty, Zed, Herdr, OMP, and Conjure.
|
|
|
|
## Requirements
|
|
|
|
This setup targets macOS and requires:
|
|
|
|
- [Homebrew](https://brew.sh/)
|
|
- Go 1.26 or newer
|
|
- Tinty 0.34 or newer
|
|
- [`dark-notify`](https://github.com/cormacrelf/dark-notify) for automatic switching when macOS changes appearance
|
|
- `make` from the Xcode Command Line Tools
|
|
|
|
Install the required tools:
|
|
|
|
```sh
|
|
xcode-select --install
|
|
brew tap tinted-theming/tinted
|
|
brew install tinty go
|
|
brew install cormacrelf/tap/dark-notify
|
|
```
|
|
|
|
Ghostty, Zed, Herdr, OMP, and Conjure are optional consumers. Install only the applications you use.
|
|
|
|
## Install
|
|
|
|
From this directory, run:
|
|
|
|
```sh
|
|
make install
|
|
```
|
|
|
|
The installer:
|
|
|
|
- Builds `~/.local/bin/tint`.
|
|
- Installs `config.toml` under `$XDG_CONFIG_HOME/tinted-theming/tinty`, or `~/.config/tinted-theming/tinty` when `XDG_CONFIG_HOME` is unset.
|
|
- Copies `state.toml` only when no state file already exists.
|
|
- Creates `~/.config/herdr/config.toml` if needed.
|
|
- Runs `tinty sync` to download the configured theme repositories.
|
|
- Creates and loads a `dark-notify` LaunchAgent for automatic macOS appearance switching.
|
|
|
|
Add the binary directory to your shell path:
|
|
|
|
```sh
|
|
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
|
|
source ~/.zshrc
|
|
```
|
|
|
|
Verify the installation:
|
|
|
|
```sh
|
|
which tint
|
|
tinty --version
|
|
tint
|
|
```
|
|
|
|
## Automatic light/dark switching
|
|
|
|
`make install` creates and loads `~/Library/LaunchAgents/dev.tinty.dark-notify.plist`. The agent starts at login, restarts if it exits, and invokes `tint light` or `tint dark` whenever macOS changes appearance.
|
|
|
|
Confirm that the agent is running:
|
|
|
|
```sh
|
|
launchctl print "gui/$(id -u)/dev.tinty.dark-notify"
|
|
```
|
|
|
|
Inspect its output if an application does not update:
|
|
|
|
```sh
|
|
tail -f ~/Library/Logs/dark-notify.log
|
|
```
|
|
|
|
## Application setup
|
|
|
|
### Ghostty
|
|
|
|
The Tinty hook writes:
|
|
|
|
```text
|
|
~/.config/ghostty/themes/tinted-theming
|
|
```
|
|
|
|
Select it in the Ghostty configuration:
|
|
|
|
```text
|
|
theme = tinted-theming
|
|
```
|
|
|
|
The hook sends `SIGUSR2` to reload Ghostty after applying a theme.
|
|
|
|
### Zed
|
|
|
|
The wrapper writes:
|
|
|
|
```text
|
|
~/.config/zed/themes/tinty-current.json
|
|
```
|
|
|
|
After applying the first theme, select `Tinty Current` in Zed.
|
|
|
|
### Herdr
|
|
|
|
The wrapper maintains a generated `[theme.custom]` block in:
|
|
|
|
```text
|
|
~/.config/herdr/config.toml
|
|
```
|
|
|
|
When the `herdr` executable is available, the wrapper also runs `herdr server reload-config`.
|
|
|
|
### OMP
|
|
|
|
The wrapper writes:
|
|
|
|
```text
|
|
~/.omp/agent/themes/tinty-current.json
|
|
```
|
|
|
|
Configure OMP to use `tinty-current` where required.
|
|
|
|
### Conjure
|
|
|
|
The `apply-apps` flow writes `$XDG_CONFIG_HOME/conjure/theme.json`, falling back to `~/.config/conjure/theme.json` when `XDG_CONFIG_HOME` is unset, empty, or relative. The generated JSON contains seven opaque colors: `background`, `text`, `secondaryText`, `accent`, `glow`, `keyBackground`, and `error`, using Tinty semantic UI colors with Base16/Base24 or tinted8 palette fallbacks.
|
|
|
|
Opt in by adding this to `conjure/config.json` in the same configuration directory:
|
|
|
|
```json
|
|
{"theme":"tint"}
|
|
```
|
|
|
|
The wrapper never changes `config.json`. Optional entries in its `colors` object override generated colors. Conjure reads configuration only at launch: restart Conjure after applying a theme or editing its configuration. The wrapper does not signal, reload, restart, or notify Conjure.
|
|
|
|
## Usage
|
|
|
|
Show the current pair and available commands:
|
|
|
|
```sh
|
|
tint
|
|
```
|
|
|
|
Select a named pair:
|
|
|
|
```sh
|
|
tint swamp
|
|
```
|
|
|
|
Apply one side of the current pair:
|
|
|
|
```sh
|
|
tint light
|
|
tint dark
|
|
```
|
|
|
|
Set both sides:
|
|
|
|
```sh
|
|
tint light:base16-swamp-light dark:base16-swamp-dark
|
|
```
|
|
|
|
Save and favorite a named pair:
|
|
|
|
```sh
|
|
tint pair swamp dark:base16-swamp-dark light:base16-swamp-light
|
|
tint favorite swamp
|
|
```
|
|
|
|
Force appearance selection for scripts or troubleshooting:
|
|
|
|
```sh
|
|
TINTY_PAIR_APPEARANCE=light tint swamp
|
|
TINTY_PAIR_APPEARANCE=dark tint swamp
|
|
```
|
|
|
|
## Update
|
|
|
|
After changing or updating the wrapper source:
|
|
|
|
```sh
|
|
make install
|
|
```
|
|
|
|
Existing `state.toml` content is preserved.
|
|
|
|
## Uninstall
|
|
|
|
```sh
|
|
make uninstall
|
|
```
|
|
|
|
This unloads and removes the LaunchAgent, log, and `tint` binary. It also removes configuration, state, and the empty Herdr configuration only when they were originally created by `make install`; pre-existing user files are preserved. Tinty itself and its shared data remain installed.
|
|
|
|
## Licensed under GPL-3.0
|
|
|
|
In plain terms:
|
|
|
|
- Anyone may use, copy, modify, and sell the software.
|
|
- Distributed copies must remain GPL-3.0.
|
|
- Modified versions must clearly say they were changed.
|
|
- Distributing binaries requires providing the corresponding source code.
|
|
- Recipients receive the same rights to modify and redistribute.
|
|
- Distributors cannot add restrictions that contradict the GPL.
|
|
- Patent rights cannot be used to make the software effectively proprietary.
|
|
- Hardware distributors cannot prevent users from installing modified versions.
|
|
- The software comes without warranty or liability.
|
|
- Private use and private modifications impose no publication requirement.
|
|
- Merely using the software over a network does not require publishing changes; that requirement belongs to the AGPL.
|
|
|
|
For details, see the actual [LICENSE](LICENSE).
|