@kecan0406/ttheme 1.0.1 → 1.0.3

package/README.md

@@ -75,9 +75,12 @@ 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. 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
+`ttheme · default`, always wears your default palette (none under `keep`), and
+init makes it iTerm2's default profile, so new tabs and windows open wearing the
+palette and its picture from their first frame and follow `ttheme default` from
+then on. iTerm2 reads its default profile only when it starts, so quit and
+reopen it once after init. The profile it replaces stays the parent of every
+ttheme profile, so your font and keys carry over, and `keep` gives it back. 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
@@ -203,22 +206,27 @@ 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.
+position setting, so a tuned picture that is not centered is baked onto a canvas
+the size of the window, as the sizes above 100% are.
 
 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
-safebooru; tab moves to yande.re, then konachan, then danbooru, then back — they
-share one tag vocabulary, so the same tag works on each, and danbooru here is
-`safebooru.donmai.us`, the mirror that carries general-rated posts only. The
+danbooru; tab moves to konachan, then yande.re, then back — they share one tag
+vocabulary, so the same tag works on each. danbooru and yande.re carry every
+rating and `TTHEME_FIND_RATING` picks which come through; konachan is
+`konachan.net`, the mirror that carries safe posts only, since `konachan.com`
+answers with a Cloudflare challenge. When a site's connection is cut off — the
+way a network that blocks boorus by name drops danbooru — find asks whether to
+turn on the unblock proxy (`TTHEME_FIND_UNBLOCK`); `y` saves the setting and
+opens find again through it, `n` leaves it off. The
 sites sit in a strip of tabs under the query, the one you are on lit in its own
 color, and it comes again as a badge at the start of the line above a picture
 you try on, next to the site the artwork itself came from when the post records
 one (`pixiv.net`, `deviantart.com`). The grid starts
 with every post of the character; `c` narrows it to **cutouts** — posts carrying
-the site's transparency tags (`transparent_background` or `vector_trace` on
-safebooru, `transparent_png` on yande.re, `transparent` or `vector` on konachan,
-`transparent_background` on danbooru) whose PNG header says they have
+the site's transparency tags (`transparent_background` on danbooru,
+`transparent` or `vector` on konachan, `transparent_png` on yande.re) whose PNG header says they have
 an alpha channel; yande.re's `transparent_png` already means exactly that, so
 its posts skip the header check, which its slow file server would drag out —
 and the counter reads shown out of checked, `13/33`. find checks only as far as
@@ -229,12 +237,14 @@ few of those tags, so `TTHEME_FIND_CUTOUTS` names the ones to look for, site by
 site.
 
 Under each thumbnail is its post id and size, and under that whoever made it:
-the artist where the site names one — yande.re, konachan and danbooru answer
-with the tag types, so it costs no extra request — and the uploader as
-`@name` where it does not, which is every safebooru post. A score follows as
+the artist, which every site names through its tag types at no extra
+request, and the uploader as `@name` where a post has no artist tag. A score follows as
 `★22` on the sites that keep one. When the same hand uploads the same picture at
-the same size over and over, find folds that run into one tile marked `×9`;
-space unfolds it and folds it again. Pictures by the uploader of the backgrounds
+the same size over and over, find folds that run into one tile marked `×9`,
+wherever the order puts its pictures, and folds in the same way a picture
+another site holds too — re-encoded at the same shape, cut from the post its
+source names, or hung under the same parent; space unfolds it and folds it
+again. Pictures by the uploader of the backgrounds
 you already have in the same series come first and carry `≈`, so a series keeps
 one hand; anything under 1600 px on its long edge shows its size in yellow.
 
@@ -249,7 +259,10 @@ the screen never hides what it is filtering by.
 
 `/` opens the query for editing — type a tag to search for something else, or paste a post url or id
 (`https://yande.re/post/show/214705`, `konachan:244200`, `7159377`) to go
-straight to that one picture. A palette with no `meta.booru` tag at all opens
+straight to that one picture. While you type, danbooru's tag completion lists
+up to eight tags that start like the last word, each with its post count — the
+way to find a costume variant such as `amane_suzuha_(beta)` or a tag you only
+half remember; `↑`/`↓` pick one and enter searches it. A palette with no `meta.booru` tag at all opens
 find on that empty query, so it can have a background too. `o` opens the post's
 page in a browser.
 
@@ -264,10 +277,12 @@ marks the picture `cut out`, and `x` switches between the cut-out and the pictur
 as it is. When Vision finds no character, or would leave almost nothing or
 remove almost nothing, the picture stays opaque; elsewhere it always does. A post over 25 megapixels is
 fetched as the site's own smaller copy instead — up to 3500 px on yande.re and
-konachan, 850 px on safebooru and danbooru — and its size carries `↓`; those
+konachan, 850 px on danbooru — and its size carries `↓`; those
 copies are JPEGs, so a cutout tried on that way comes out opaque. `←`/`→` try
-the neighbours, which find fetches ahead of you two at a time, enter installs,
-and the preview carries on straight into the tuning panel below. `c` switches
+the neighbours, which find fetches ahead of you two at a time, and enter installs
+and returns to the grid with the tile marked `✓`, the tab, search and scroll as
+you left them; esc then hands the last one installed to the preview, which
+carries on straight into the tuning panel below. `c` switches
 between every post and the cutouts, esc goes back. Unless the settings say otherwise,
 only `safe` and `general` posts are shown, and none tagged with nudity or
 underwear (`nude`, `panties` and each site's own spelling of them) — with only
@@ -280,8 +295,12 @@ When a site asks ttheme to slow down, find waits as long as it names, up to a
 minute, with a countdown at the bottom. ttheme keeps no
 list of images — the tag is all it knows about a character.
 
-An install writes `<palette>.png` (the tinted figure), `<palette>@fill-<focus>.png`
-(the window-shaped crop), `<palette>.conf` and the untouched original under
+An install writes `<palette>.<hash>.png` (the tinted figure),
+`<palette>.<hash>@fill-<focus>.png` (the picture made at the shape of the window
+find ran in: a cut-out stands whole from its head down against the right edge, a
+little taller than the window, and a wallpaper covers it from its top) — the hash is of
+their content, because Ghostty and iTerm2 reload a background only when its path
+changes, so no two pictures may share a name — `<palette>.conf` and the untouched original under
 `backgrounds/originals/`, and starts it untuned — the picture it replaces moves
 to the shelf with the tuning it had. The
 conf opens with where the picture came from —
@@ -300,8 +319,8 @@ steps at a time). Size walks 1% at a time, shown large in the middle of the
 screen as it changes: 100% is the whole image fitted into the window
 (`contain`), below that it shrinks to 20%, above it the image grows around the
 face until it covers the window, and the top step is **fill** (`cover`). Fill
-uses `<palette>@fill-<focus>.png` when it sits beside the image — a crop made
-to fill the window, whose name carries the height of the face in percent, which
+uses `<palette>.<hash>@fill-<focus>.png` when it sits beside the image — a crop made
+to fill the window, whose name carries the height of the figure at the window's middle, which
 the sizes above 100% zoom around — and the image itself otherwise. Position
 steps through the nine `background-image-position` anchors, or `1`–`9` jump to
 one in reading order; opacity moves by 0.01. Space turns the palette's
@@ -320,13 +339,16 @@ picture before `,` or `.` moves off it.
 The palette's `.conf` holds those defaults; the preview only appends two
 optional includes to it and keeps everything else in `<palette>.tune.conf` (the
 tuning) and `<palette>.off.conf` (the off switch), which Ghostty loads after
-the conf. Kept changes are written when the preview closes, by whichever key, and
-Ghostty reloads when that palette is the default. Ghostty has no scale setting,
+the conf. Kept changes are written when the preview closes, by whichever key,
+and reach both terminals from whichever one ran the preview: Ghostty reloads
+when it is showing that palette, and iTerm2's profiles are rewritten. Ghostty has no scale setting,
 so every size but 100% and fill is baked into a copy beside the image and the
 tuning points at it: below 100% onto a transparent canvas of the image's own
-size (`kagami@60-bottom-right.png`, fitted with `contain`), above it onto one of
-the window's size at the time (`kagami@130-center-2880x1800.png`, with
-`cover`). Baking runs `sips`, so those sizes are offered on macOS only.
+size (`kagami.1a2b3c4d@60-bottom-right.png`, fitted with `contain`), above it onto
+one of the window's size at the time (`kagami.1a2b3c4d@130-center-2880x1800.png`,
+with `cover`). With iTerm2 wired, a size of 100% or less that is not centered
+goes onto the window-sized canvas too, since iTerm2 cannot place an image.
+Baking runs `sips`, so those sizes are offered on macOS only.
 
 The preview draws inside the cell grid, and Ghostty's `window-padding` around
 it keeps showing the configured background. While the cursor rests on the
@@ -355,9 +377,11 @@ With `TTHEME_TAB_PALETTE=seq`, new tabs take the next palette in group order, wi
 tabs — so opening four tabs walks you through four different characters rather
 than rolling the same one twice.
 
-Settings live in `~/.config/ttheme/config.zsh` — `init` seeds it with the
-defaults and never overwrites a line you changed — bar `TTHEME_TAB_PALETTE`, which its
-default/rotate/keep question sets — `ttheme config` opens it in `$EDITOR` and alt-c in `preview` edits it in place. Each line is a plain zsh
+Settings live in `~/.config/ttheme/config.zsh` — `init` seeds it with every
+setting at its default on a commented line, so a default a later version changes
+reaches you, and never overwrites a line you changed — bar `TTHEME_TAB_PALETTE`, which its
+default/rotate/keep question sets — `ttheme config` opens it in `$EDITOR` and alt-c in `preview` edits it in place. Only a value that differs from the default
+is left uncommented; setting one back comments it out again. Each line is a plain zsh
 `: ${VAR:=value}` assignment, so a variable exported before the layer loads
 still wins:
 
@@ -370,12 +394,13 @@ still wins:
 | `TTHEME_FIND_RATING` | `safe` | the ratings `find` lists, any of `safe`, `questionable` and `explicit` separated by spaces (`"safe explicit"`). Each site is read in its own vocabulary, so danbooru's `s` (sensitive) is not mistaken for yande.re's `s` (safe). The set shows next to the query whenever it is not just `safe` |
 | `TTHEME_FIND_BLOCK` | `nudity underwear` | the posts `find` drops by tag: `nudity` (`nude`, `naked`, `topless`…), `underwear` (`panties`, `bra`, `lingerie`… — each with the site's own spelling), both, or `none` to keep every post. What is let through shows next to the query as `allows …` |
 | `TTHEME_FIND_POSTS` | `all` | what `find` opens on — every post of the character, or only the transparent cutouts (`cutouts`) |
-| `TTHEME_FIND_CUTOUTS` | — | the tags `find` calls a transparent cutout, as `key=tag,tag` pairs separated by spaces, keyed by `safebooru`, `yande`, `konachan` or `danbooru` (`safebooru=transparent_background yande=transparent_png,vector`). A site with several tags matches any of them; `danbooru=` names none, so its cutouts are the posts whose PNG header has an alpha channel. A site named here loses yande.re's shortcut of skipping that header check. Sites left out keep the built-in tags |
-| `TTHEME_FIND_ORDER` | `newest` | the order `find` lists posts in — `newest` or `score` |
-| `TTHEME_FIND_SETS` | `fold` | a run of the same picture at the same size from one uploader: `fold` shows it as one tile marked `×N`, `show` lists every one |
+| `TTHEME_FIND_CUTOUTS` | — | the tags `find` calls a transparent cutout, as `key=tag,tag` pairs separated by spaces, keyed by `danbooru`, `konachan` or `yande` (`konachan=transparent,vector yande=transparent_png`). A site with several tags matches any of them; `danbooru=` names none, so its cutouts are the posts whose PNG header has an alpha channel. A site named here loses yande.re's shortcut of skipping that header check. Sites left out keep the built-in tags |
+| `TTHEME_FIND_SOLO` | `on` | `on` keeps only the posts tagged `solo` — the character alone, which is what a backdrop needs. konachan and yande.re do not tag how many people a picture shows, so their posts borrow the tags danbooru holds for the same file, one request per page; a post danbooru does not have is left alone. The query line says `solo` while it is on |
+| `TTHEME_FIND_ORDER` | `fit` | the order `find` lists posts in — `fit` ranks each page it fetches by how well a post makes a backdrop (solo, resolution against the window, a cutout or an aspect close to the window's, score within the page, the palette's colors in its preview; comics, monochrome, sketches and landscapes sink) and appends it below what is already shown, so nothing moves under you; `newest`; or `score` |
+| `TTHEME_FIND_SETS` | `fold` | a run of the same picture at the same size from one uploader, and a picture another site holds too: `fold` shows it as one tile marked `×N`, `show` lists every one |
 | `TTHEME_FIND_REMOVE_BG` | `on` | on macOS, `on` cuts the character out of an opaque picture `find` tries on, with the system's Vision framework; `off` leaves it as it is. The row is in the `s` panel as `remove bg` |
-| `TTHEME_FIND_UNBLOCK` | `0` | `1` sends `find`'s own requests through a proxy it runs on `127.0.0.1`, which splits the TLS handshake across two records so a network that blocks boorus by hostname cannot read the name. It is not a VPN: the address you reach is unchanged and nothing else on the machine is affected. Needs node 22.21 or newer, and the query line says `unblock` while it is on |
-| `TTHEME_FIND_HOSTS` | — | send a `find` site somewhere else, as `key=https://host` pairs (`konachan=https://konachan.com danbooru=https://danbooru.donmai.us`). The tab keeps its name and carries `*`. ttheme ships the safe mirrors only; the hosts that serve everything are yours to name, and plenty of networks block them |
+| `TTHEME_FIND_UNBLOCK` | `0` | find offers to turn it on when a site's connection is cut off. `1` sends `find`'s requests to danbooru through a proxy it runs on `127.0.0.1`, which splits the TLS handshake across two records so a network that blocks it by hostname cannot read the name; konachan and yande.re, which no network is known to block, still go direct. It is not a VPN: the address you reach is unchanged and nothing else on the machine is affected. Needs node 22.21 or newer, and the query line says `unblock` while it is on |
+| `TTHEME_FIND_HOSTS` | — | send a `find` site somewhere else, as `key=https://host` pairs (`danbooru=https://safebooru.donmai.us`, the general-rated mirror, reachable where danbooru is blocked). The tab keeps its name and carries `*` |
 
 ## The catalog
 
@@ -459,7 +484,7 @@ name = "madoka"                            # must match the filename
 group = "Madoka Magica"                    # needs a [[group]] in themes/_groups.toml
 order = 15                                 # position in the rotation
 ansi_source = "Elegant + Magica"           # what the harmonizer was fed
-booru = "kaname_madoka"                    # safebooru character tag find searches
+booru = "kaname_madoka"                    # booru character tag find searches
 signature = ["cursor", "ansi1", "ansi3"]   # the three slots the site draws as identity
 
 [colors]