@kecan0406/ttheme 1.0.0 → 1.0.1

package/README.md

@@ -74,9 +74,10 @@ so cancelling before that touches nothing. It places the zsh layer under
 left alone. iTerm2 has no config file to edit, so it gets one profile per
 installed palette instead — `ttheme · miku` and so on, in
 `~/Library/Application Support/iTerm2/DynamicProfiles/ttheme.json`, which
-iTerm2 reloads by itself whenever `ttheme browse` adds or drops one. iTerm2
-keeps its own default profile: Set as Default on one under Settings › Profiles
-and every new tab wears it. It ends with a receipt, paints the first palette onto the tab you
+iTerm2 reloads by itself whenever `ttheme browse` adds or drops one. One more,
+`ttheme · default`, always wears your default palette (none under `keep`): Set
+as Default on it once under Settings › Profiles and new tabs follow `ttheme
+default` from then on. It ends with a receipt, paints the first palette onto the tab you
 ran it in (not under `keep`) and lists what to do next (`exec zsh` for the
 `ttheme` command here, a terminal restart for new tabs).
 Running it again updates in place; `--yes` skips every prompt and installs no
@@ -160,11 +161,12 @@ the cursor. The list and the sample widen with the window (the sample up to 64
 columns) and the gap between them takes the rest; the tuning panel takes the
 sample's place while open, and so does the key list once the sample is 48
 columns wide.
-Under Ghostty with `TTHEME_TAB_PALETTE=off` (the default), enter asks **this tab** or
+Under Ghostty or iTerm2 with `TTHEME_TAB_PALETTE=off` (the default), enter asks **this tab** or
 **default**: default records the palette as your default palette (so a later
 `add` or `remove` keeps it), rewrites `theme =` in the `# ttheme begin` block of
-your Ghostty config and sends `SIGUSR2` to the Ghostty that owns the tab, so new tabs — and open tabs you have not
-painted by hand — take the palette without a restart. Painting is per surface
+your Ghostty config and sends `SIGUSR2` to the Ghostty that owns the tab, and
+rewrites iTerm2's `ttheme · default` profile, which iTerm2 reloads by itself — so new tabs, and open tabs you have not
+painted by hand, take the palette without a restart. Painting is per surface
 otherwise: a new tab starts from the configured theme, not from what the last
 tab was painted.
 
@@ -192,6 +194,17 @@ none. A tab busy with a command catches up at its next prompt, focus reporting
 is off while that command runs, and a tab whose colors are not a ttheme palette
 leaves the picture where it is.
 
+iTerm2 keeps a picture per tab. There the picture lives in the palette's own
+profile — `ttheme · kagami` carries the file, its opacity as Blend and cover or
+contain as the image mode, rewritten whenever the picture or its tuning
+changes — and putting a palette with a picture on, or taking one off, moves the
+tab to that palette's profile with `OSC 1337 SetProfile`. The first time,
+iTerm2 asks at the top of the tab whether a control sequence may change the
+profile: Always Allow lets every later switch through — put the palette on once
+more for the one that asked — and a tab it refuses still wears the palette's
+colors, only without the picture. iTerm2 has no
+position setting, so a picture that does not fill the window sits centered.
+
 A palette with no background yet can find one: on it in `preview`, tab opens
 **find**, which searches a booru for the palette's character tag
 (`meta.booru`) and lays the results out as a grid of thumbnails. It starts on
@@ -276,8 +289,8 @@ conf opens with where the picture came from —
 panel shows it next to the palette's name.
 
 `preview` shows the background of the palette under the cursor while you
-browse: through the kitty graphics protocol it draws that palette's
-`background-image` where Ghostty would place it, faded by
+browse: through the kitty graphics protocol (Ghostty, and iTerm2 3.7 or newer)
+it draws that palette's `background-image` where Ghostty would place it, faded by
 `background-image-opacity`, behind the list — or just its plain background when
 it has no file. Only PNG images preview.