@kecan0406/ttheme 0.1.1 → 0.1.3

package/README.md

@@ -62,16 +62,17 @@ came from — `ttheme` prints it, and it is in the theme's TOML.
 npx @kecan0406/ttheme@latest init
 ```
 
-It detects your terminal, asks which ones to wire, places the zsh layer under
-`~/.config/ttheme`, and edits your terminal config and `~/.zshrc` between
-`# ttheme begin` / `# ttheme end` markers — everything outside the markers is
-left alone. Running it again updates in place; `--yes` skips every prompt and
-takes the defaults.
-
-**`init` installs no palettes.** It sets the machinery up and then offers the
-catalog a series at a time — `tab` marks a series, enter installs every palette
-in it; `ttheme browse` opens the full catalog any time, to add or drop single
-palettes.
+It asks which terminals to wire and which series to install — `space` marks
+one, enter moves on, and `select all` takes the lot — then shows what it is
+about to change and writes it all at once, so cancelling before that touches
+nothing. It places the zsh layer under `~/.config/ttheme` and edits your
+terminal config and `~/.zshrc` between `# ttheme begin` / `# ttheme end`
+markers — everything outside the markers is left alone. It ends with a receipt,
+paints the first palette onto the tab you ran it in 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
+palettes — `ttheme browse` opens the full catalog any time, to add or drop
+single palettes.
 
 **WezTerm and iTerm2** — one archive per terminal in the
 [latest release](https://github.com/kecan0406/ttheme/releases/latest):
@@ -177,28 +178,76 @@ rather than the palette painted on one tab.
 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; `p` moves to yande.re, then konachan, then back — the three share
-one tag vocabulary, so the same tag works on each. The site you are on sits in
-a colored badge at the top right, and again 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 **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) whose PNG header says they have
+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
+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
 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`. 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. 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 allows —
-over a sample of shell output, with the share of transparent pixels next to its
-size (`opaque` when there are none). `←`/`→` try the neighbours, enter installs,
-and the preview carries on straight into the tuning panel below. Tab switches to
-every post of the character, esc goes back. Only `safe` and `general` posts are
-ever shown — yande.re and konachan are always asked for `rating:s`, whatever
-else is searched — and downloads stay in `~/.cache/ttheme/<site>/`. ttheme keeps no
+and the counter reads shown out of checked, `13/33`. find checks only as far as
+the grid reaches and checks more as you scroll; each answer is remembered, so
+coming back to a site or a palette never asks its file server again, and a site
+you have already seen comes back the moment you tab to it. Newer series carry
+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
+`★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
+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.
+
+`s` opens the settings — the ratings to list, the nudity and underwear tags to
+block, cutouts or all, newest or score, and whether runs fold — with ↑↓ on the
+setting, enter to save them to `config.zsh` and esc to put them back. ←→ change
+a value; on the two rows of checkboxes (rating and block) they move between the
+boxes and space ticks one, so `safe` and `explicit` can be listed without
+`questionable`, or underwear let through while nudity stays blocked. At least
+one rating stays ticked. Whatever is not the default shows next to the query, so
+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
+find on that empty query, so it can have a background too. `o` opens the post's
+page in a browser.
+
+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
+allows — over a sample of shell output, with the share of transparent pixels
+next to its size (`opaque` when there are none). On macOS an opaque picture is
+cut out first: ttheme asks the system's own Vision framework (macOS 14 or newer,
+through `osascript` — nothing is installed or uploaded) for the character alone,
+marks the picture `cut out`, and `x` switches between the cut-out and the picture
+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
+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
+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
+`safe` ticked yande.re and konachan are asked for `rating:s`, whatever else is
+searched; ticking more ratings or unticking a block in the `s` panel widen it. danbooru takes only two tags from a
+signed-out search, so on it a cutout search leaves the score order out and says
+so. Thumbnails and header checks stay in
+`~/.cache/ttheme/<site>/`; the pictures you try on last only while find is open.
+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`
@@ -267,8 +316,8 @@ New tabs take the next palette in group order, with the counter shared across
 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 from your
-answers, `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 the
+defaults and never overwrites a line you changed, `ttheme config` opens it in `$EDITOR` and alt-c in `preview` edits it in place. Each line is a plain zsh
 `: ${VAR:=value}` assignment, so a variable exported before the layer loads
 still wins:
 
@@ -278,23 +327,35 @@ still wins:
 | `TTHEME_ANNOUNCE` | `1` | `0` silences the one-line notice under "Last login:" |
 | `TTHEME_FX` | `typewriter` | search hint animation — `typewriter`, `decode` or `glitch` |
 | `TTHEME_SORT` | `abc` | `series` lists series and palettes in the order they were added instead of by name — in `ttheme`, `preview` and, once exported, the `init` picker |
+| `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_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 |
 
 ## The catalog
 
-A fresh install carries no palettes at all. `ttheme browse` opens the catalog as
-a live picker — groups fold and unfold, typing filters, the tab repaints as the
-cursor lands on a palette, `tab` marks one (or a whole series from its header),
-and enter installs exactly what is marked and removes what is not:
+The catalog is not installed wholesale: `init` installs the series you pick, and
+`init --yes` none at all. `ttheme browse` opens the catalog as a live picker —
+groups fold and unfold, typing filters (a query has no spaces, `space` is the
+pick key), the tab repaints as the cursor lands on a palette, `space` marks one
+(a series from its header, everything shown from `select all`), and enter
+installs exactly what is marked and removes what is not:
 
 ```
 ◆ catalog (4/107 · 2 picked)
 │ ⌕ bo_
+│   ○ select all (4)
 │ ▾ Bocchi the Rock! (2/4) ぼっち・ざ・ろっく!
 │   ▶ ● bocchi        ● ▁▁▁▁▁▁  Sakura + Kessoku
 │     ● kita          ● ▁▁▁▁▁▁  Wild Cherry + Kessoku
 │     ○ nijika        ● ▁▁▁▁▁▁  Medallion
 │     ○ ryo           ● ▁▁▁▁▁▁  TokyoNight Storm
-└ ↑↓ move · ←→ fold · tab pick · type to filter · enter install · esc cancel
+└ ↑↓ move · ←→ fold · space pick · type to filter · enter install · esc cancel
 ```
 
 The counts stay honest: `4/107` is what the filter matched out of the catalog,