From 1eb0ac3705276c6f81f44487c7e99c24a302d4d5 Mon Sep 17 00:00:00 2001 From: Igor Soarez Date: Sun, 25 Oct 2026 20:58:35 +0200 Subject: readme: how to add the tmux snippet, and what it changes added by hand, at the end of the tmux config. it replaces status-right, turns on focus-events, adds hooks at index 77 and a status-line click binding (needs mouse on); changes apply at the next reload. --- README.md | 23 +++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 41ad3f6..a0c4097 100644 --- a/README.md +++ b/README.md @@ -135,8 +135,27 @@ swiftc -O -o target/dingger-menu menubar/*.swift # menu bar + panel, bundled - launchd agents (start at login, restart on exit): `packaging/launchd/dev.dingger.{dingger,menubar}.plist`; adjust the user path, copy to `~/Library/LaunchAgents/`, `launchctl bootstrap gui/$(id -u) `. -- tmux: `source-file /path/to/dingger/packaging/tmux/dingger.tmux` (needs - `set -g mouse on` for the click). +- tmux: you add the snippet yourself; no `dingger install` command does it. + Put this line at the end of your tmux config (`~/.tmux.conf`, or a file + it sources): + + ```tmux + source-file /path/to/dingger/packaging/tmux/dingger.tmux + ``` + + Then reload: `tmux source-file ~/.tmux.conf`. The snippet: + - **replaces** `status-right` with the restore offer, `%d-%b %H:%M`, and + the agent counts. Your own `status-right` is lost, so put the line after + it, or edit the snippet's `status-right` to keep what you had; + - turns on `focus-events`, which raising the right Ghostty window needs; + - adds hooks that report focus and navigation to dingger. They use index + `[77]`, so they keep your own hooks on the same events, and reloading + does not duplicate them; + - binds clicks on the right of the status line, which needs + `set -g mouse on`. + + The line sources the snippet from the repo, so a changed snippet applies + at the next reload. dingger does not need tmux running first; it attaches when a server appears. -- cgit v1.2.3