back up project

2026-09-18 00:21:11 +02:00
commit ffe8b986ce
10 changed files with 1322 additions and 0 deletions
@@ -0,0 +1,179 @@
+# 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, and OMP.
+
+## 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, and OMP 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.
+
+## 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.