@kecan0406/ttheme 1.0.31 → 1.0.32

package/README.md

@@ -30,7 +30,7 @@ get it.
 | **Runtime repaint** | ![Done][done] | ![Done][done] | ![Done][done] | ![Done][done] | ![Done][done] | ![Done][done] | ![No][no] | ![Done][done] | ![Partial][partial] |
 | **Font** | ![Done][done] | ![No][no] | ![Done][done] | ![Done][done] | ![Done][done] | ![No][no] | ![No][no] | ![No][no] | ![No][no] |
 | **Shader** | ![Done][done] | ![No][no] | ![No][no] | ![No][no] | ![No][no] | ![No][no] | ![No][no] | ![No][no] | ![No][no] |
-| **Background pictures** | ![Done][done] | ![Done][done] | ![No][no] | ![No][no] | ![Partial][partial] | ![No][no] | ![No][no] | ![No][no] | ![No][no] |
+| **Background pictures** | ![Done][done] | ![Done][done] | ![Done][done] | ![No][no] | ![Partial][partial] | ![No][no] | ![No][no] | ![No][no] | ![No][no] |
 
 - **Setup with `init`** — iTerm2 is offered on macOS only, Windows Terminal
   from WSL (or a native Windows zsh), where init writes a settings fragment on
@@ -39,8 +39,12 @@ get it.
 - **Palette files** — iTerm2 gets one dynamic profile per palette, plus
   `.itermcolors` in the archive; Windows Terminal gets one fragment carrying
   every installed scheme.
-- **Runtime repaint** — Ghostty and kitty through native adapters, the rest
-  through OSC escape sequences, per pane in WezTerm and Windows Terminal.
+- **Runtime repaint** — OSC escape sequences everywhere, per pane in kitty,
+  WezTerm and Windows Terminal, one color per sequence (Alacritty drops an OSC 4
+  carrying more than seven). kitty and Windows Terminal reset every OSC color
+  when their config reloads, so a changed default would undo the palettes open
+  tabs wear: kitty's watcher puts each window's palette back as the reload ends,
+  and a Windows Terminal tab repaints itself at its next prompt or focus.
   Terminal.app takes every OSC color but no OSC reset, so ttheme reads its
   colors when the shell starts and puts them back itself. Warp answers OSC
   color queries but paints one theme app-wide and never the background an OSC
@@ -52,10 +56,11 @@ get it.
   Terminal and Warp the one you set in them.
 - **Background pictures** — `find`, `ttheme image` and `preview`'s live
   backdrop. Ghostty shows one picture app-wide, following the focused tab;
-  iTerm2 (3.7 or newer) shows one per tab. WezTerm shows the picture of the
-  active tab per window and switches it as `preview` moves, but has no
-  in-terminal preview or tuning — find and tune from Ghostty or iTerm2. Cut-outs
-  and baked crops need macOS.
+  iTerm2 (3.7 or newer) shows one per tab and kitty one per window (a split
+  pane included), both with the same preview, tuning and find. WezTerm shows the
+  picture of the active tab per window and switches it as `preview` moves, but
+  has no in-terminal preview or tuning — find and tune from Ghostty, iTerm2 or
+  kitty. Alacritty has no graphics at all. Cut-outs and baked crops need macOS.
 
 [done]: https://img.shields.io/badge/Done-2ea44f?style=flat-square
 [partial]: https://img.shields.io/badge/Partial-e3b341?style=flat-square
@@ -329,6 +334,26 @@ half remember; `↑`/`↓` pick one and enter searches it. A palette with no `me
 find on that empty query, so it can have a background too. `o` opens the post's
 page in a browser.
 
+A picture of your own goes in the same way. Drop an image file on the window
+while find is open, or paste it — a file copied in Finder, its path, or a link
+to the image — and find tries it on as if it were a post. `ctrl+v` (or `v`
+outside the search field, `alt+v` on Windows) reads the clipboard itself, which
+is how a screenshot or a browser's "Copy Image" gets in, since no terminal
+pastes picture data as text — on macOS ctrl+shift+cmd+4 takes a screenshot
+straight to the clipboard. When the window comes back into focus with a picture
+on the clipboard, find says so for a few seconds; text on the clipboard that is
+neither a file nor a link goes into the search field instead. Every terminal hands a dropped
+file over as its path, each quoted its own way, and find reads them all; kitty
+and iTerm2 3.7 also deliver the dropped picture itself through kitty's
+drag-and-drop protocol, so a picture dragged out of a browser works there too,
+and kitty's clipboard protocol makes Cmd+V with a picture on the clipboard work
+directly, over ssh as well. PNG and JPEG work everywhere; macOS converts any
+other picture (HEIC, WebP, GIF, TIFF…) and shrinks one over 25 megapixels. The
+installed picture is named `local` in the conf's `# from` line, with the file or
+link it came from, and keeps its original under `backgrounds/originals/` like a
+booru post. Over ssh `ctrl+v` can only reach the clipboard through kitty's protocol,
+since the clipboard is on your own machine.
+
 Enter tries the picture on: ttheme downloads the original and paints the whole
 window with it the way the installed background will look — tinted with the
 palette, cropped with headroom above the face, at the opacity the contrast gate
@@ -371,7 +396,7 @@ 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 (Ghostty, and iTerm2 3.7 or newer)
+browse: through the kitty graphics protocol (Ghostty, kitty, 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.
@@ -524,6 +549,26 @@ which the shell layer sets whenever the tab's palette changes, and reads the
 picture from `backgrounds/<palette>.conf` itself — so a picture installed or
 tuned from Ghostty or iTerm2 reaches WezTerm within a second.
 
+kitty gets a watcher, `~/.config/ttheme/kitty.py`, which the kitty block loads:
+the shell layer tells it what a window wears and shows through user vars
+(`ttheme_worn`, `ttheme_shown`, `ttheme_startup`), and it answers with the
+window's logo — kitty's per-window picture, drawn above the default background
+and below any cell with a background of its own, which does not scroll — read
+from `backgrounds/<palette>.conf` itself, so a picture tuned in another terminal
+shows the next time a kitty window takes focus. kitty 0.49 draws every logo at
+the global `window_logo_alpha` and scales every logo by `window_logo_scale`, so
+the block sets those to 1 and 100 and the watcher fades the picture's own alpha
+to the tuned opacity instead. kitty reloads its config by itself whenever
+`kitty.conf` or a file it includes changes, and a reload resets every color an
+OSC set; the watcher wraps the reload and puts each window's palette back, and
+`sync` writes a file only when its content changed, so installing palettes
+reloads nothing. The watcher reaches kitty windows opened after `init`.
+
+Alacritty reloads its config by itself and keeps OSC colors through a reload.
+`sync` puts its import in the config's own `[general]` table when there is one —
+TOML allows a table once — and leaves a config that already imports files
+there alone, with a note.
+
 iTerm2 reads the colors an OSC sets as Display P3 — its default color space — so
 its profiles and `.itermcolors` files are written in P3 too: a tab opened on a
 `ttheme · <palette>` profile and a tab repainted to that palette land on the