From 29f84c930326c8517e22be0141eea56ecef1f6cd Mon Sep 17 00:00:00 2001 From: msample <4896732+msample@users.noreply.github.com> Date: Tue, 22 Sep 2026 06:46:19 +0000 Subject: [PATCH 1/2] docs: correct the README's slideshow description and key table Three things were wrong. The tmux paragraph still described the alternate-screen rebuild as what every slide change does, with its flash presented as the price of reliability. That was replaced by the `tmux refresh-client` repaint, which costs nothing visible; the rebuild now runs only where a repaint cannot reach -- GNU screen, and tmux nested in another multiplexer -- and when `r` asks for it. The transmission verification is independent of either and now reads as its own point rather than a parenthesis inside the flash's justification. The key table claimed PgUp and PgDn were aliases for Home and End. They navigate by one slide, not to the ends: `page_keys_navigate` asserts `CSI 5~` is Prev and `CSI 6~` is Next. Anyone taking the table at its word would have thought the keys broken. Ctrl-D quits and was undocumented. Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 4fd369a..62ea654 100644 --- a/README.md +++ b/README.md @@ -77,18 +77,22 @@ When no file is given and stdin is piped, kittyview reads from stdin automatical Giving kittyview more than one file opens an interactive slideshow on the terminal's alternate screen: each image is shown fitted to the window and centred, with a status line naming the file and its position in the list. -| Key | Action | -|----------------------------------|-------------------------------| -| Right, Down, Space, `n` | next image | -| Left, Up, Backspace, `p` | previous image | -| Home / End (also PgUp / PgDn) | first / last image | -| `r` | redraw the slide from scratch | -| Ctrl-Z | suspend (resume with `fg`) | -| `q`, Esc, Ctrl-C | quit | +| Key | Action | +|-------------------------------------|-------------------------------| +| Right, Down, PgDn, Space, `n` | next image | +| Left, Up, PgUp, Backspace, `p` | previous image | +| Home / End | first / last image | +| `r` | redraw the slide from scratch | +| Ctrl-Z | suspend (resume with `fg`) | +| `q`, Esc, Ctrl-C, Ctrl-D | quit | Navigation stops at the ends of the list rather than wrapping. Files that fail to load show their error in place and are skipped past with the same keys. `--animate` plays animated slides on terminals that support the kitty animation protocol. -Under tmux, each slide change redraws by way of the pane's main screen -- a brief flash of the pane beneath, and `r` forces the same rebuild by hand. The flash buys reliability twice over: tmux silently drops passthrough sequences around pane redraws (kittyview also verifies each transmission's arrival over the protocol's reply channel, retries losses, and reports them in a diagnostics line on exit), and Ghostty releases through 1.3.1 render placeholder images delivered as in-place pane updates blank -- confirmed with the data verified present in the terminal -- while a full repaint renders them correctly. The same Ghostty releases can also render large placeholder images at the wrong size inside tmux (clipped or narrowed, [ghostty#13056](https://github.com/ghostty-org/ghostty/issues/13056)). Ghostty's nightly builds fix the rendering; kitty is unaffected. +Under tmux, each slide is repainted with `tmux refresh-client` once it is drawn -- the same full client repaint that switching panes triggers, and nothing visible changes when it runs. It re-sends no image data: the image is already in the terminal's store, and the cells that place it are ordinary text in tmux's grid. The repaint is what makes the slide render at all on Ghostty releases through 1.3.1, which draw placeholder images delivered as an in-place pane update blank, or at the wrong size -- clipped or narrowed, [ghostty#13056](https://github.com/ghostty-org/ghostty/issues/13056) -- while a full repaint draws them correctly, confirmed with the data verified present in the terminal. Ghostty's nightly builds fix the rendering; kitty is unaffected. + +Where a repaint cannot reach, each slide change instead rebuilds by way of the pane's main screen, at the cost of a brief flash of the pane beneath: GNU screen has no equivalent command, and tmux nested inside another multiplexer would hand the outer layer the repaint as one more in-place update. `r` forces that rebuild by hand on any stack. + +Separately, tmux silently drops passthrough sequences around pane redraws, so kittyview verifies each transmission's arrival over the protocol's reply channel, retries losses, and reports them in a diagnostics line on exit. The slideshow leaves the terminal exactly as it found it, on every exit path: quitting, errors, panics, and fatal signals all restore the screen, the cursor, and the terminal mode, and delete the transmitted images so the terminal's image memory is returned. `kill -9` is the one exit nothing can clean up after -- `reset` recovers the terminal if it comes to that. Ctrl-Z suspends and resumes like any well-behaved fullscreen program. From 71f0afc1d9e7591708587969ffce75a96592b622 Mon Sep 17 00:00:00 2001 From: msample <4896732+msample@users.noreply.github.com> Date: Tue, 22 Sep 2026 06:47:11 +0000 Subject: [PATCH 2/2] chore: prep 0.1.7 release Version to 0.1.7 in Cargo.toml and both lockfiles' kittyview entries, the changelog's upcoming section becomes the 0.1.7 section, and the README and SECURITY.md verification examples pin the new tag. The one change: slideshow images render fully under tmux without the inter-slide flash, by repainting the client with `tmux refresh-client` instead of rebuilding through the pane's main screen. The probe variants that isolated it ship with it. Lockfiles were regenerated with `cargo update -p kittyview` rather than hand-edited, so neither picked up unrelated dependency churn. Co-Authored-By: Claude Opus 5 (1M context) --- CHANGELOG.md | 2 +- Cargo.lock | 2 +- Cargo.toml | 2 +- README.md | 2 +- SECURITY.md | 4 ++-- fuzz/Cargo.lock | 2 +- 6 files changed, 7 insertions(+), 7 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9b26827..b4af516 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,6 @@ # Changelog -## upcoming +## 0.1.7 - **Slideshow images render fully under tmux, without the flash**: Ghostty through 1.3.1 renders placeholder images delivered as an in-place pane update blank or clipped -- with the data confirmed present in the terminal via the reply channel -- while a full repaint out of tmux's own grid renders them correctly. That is why switching tmux panes completes an image that came out partial. Every draw under a lone tmux layer now ends with `tmux refresh-client`: the same client repaint a pane switch triggers, re-sending nothing (the image is already in the terminal's store, the placeholder cells already in tmux's grid) and costing nothing visible. It replaces the alternate-screen rebuild 0.1.6 used for the same purpose, so slide changes no longer flash the pane underneath, nor pay the 250ms settle that rebuild needed. The repaint is issued after the arrival check, never before, since tmux drops passthrough while a redraw is pending and would eat the question with it; the draws that skip that check -- animations, and the message slide shown for a file that will not load -- wait the same interval before the repaint instead, since they carry passthrough of their own. Where a repaint cannot reach -- screen, which has no equivalent command, and tmux nested in another multiplexer, whose outer layer would receive the repaint as one more in-place update -- slide changes still rebuild by way of the pane's main screen; that rebuild remains the last-attempt fallback when transmissions are being lost, and what the `r` key forces by hand. - `examples/placeholder_probe` gained a second group of variants (`manual`, `refresh`, `nudge`, `rewrite`, `cycle-refresh`) that bisect the *repair* rather than the draw: given a slide that rendered wrong, which nudge completes it. On Ghostty 1.3.1 + tmux only the two that force a full client repaint do -- unrelated terminal traffic does not, and re-sending the placeholder cells in place does not -- which is what settled the fix above. diff --git a/Cargo.lock b/Cargo.lock index 994d87e..1e425c2 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -356,7 +356,7 @@ checksum = "a6cb138bb79a146c1bd460005623e142ef0181e3d0219cb493e02f7d08a35695" [[package]] name = "kittyview" -version = "0.1.6" +version = "0.1.7" dependencies = [ "base64", "clap", diff --git a/Cargo.toml b/Cargo.toml index 7ec9494..1a03d56 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "kittyview" -version = "0.1.6" +version = "0.1.7" edition = "2024" rust-version = "1.87" license = "Apache-2.0" diff --git a/README.md b/README.md index 62ea654..a24b4bf 100644 --- a/README.md +++ b/README.md @@ -35,7 +35,7 @@ Every release binary carries a [build provenance attestation](https://docs.githu ```sh gh attestation verify kittyview-linux-amd64.tar.gz \ --repo gominimal/kittyview \ - --source-ref refs/tags/v0.1.6 \ + --source-ref refs/tags/v0.1.7 \ --deny-self-hosted-runners ``` diff --git a/SECURITY.md b/SECURITY.md index 7c940cf..518edca 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -26,7 +26,7 @@ claims to -- see [Verifying downloads](README.md#verifying-downloads) for why ```sh gh attestation verify kittyview-linux-amd64.tar.gz \ --repo gominimal/kittyview \ - --source-ref refs/tags/v0.1.6 \ + --source-ref refs/tags/v0.1.7 \ --deny-self-hosted-runners ``` @@ -44,7 +44,7 @@ gh attestation trusted-root > trusted_root.jsonl ```sh gh attestation verify kittyview-linux-amd64.tar.gz \ --repo gominimal/kittyview \ - --source-ref refs/tags/v0.1.6 \ + --source-ref refs/tags/v0.1.7 \ --deny-self-hosted-runners \ --bundle kittyview-provenance.intoto.jsonl \ --custom-trusted-root trusted_root.jsonl diff --git a/fuzz/Cargo.lock b/fuzz/Cargo.lock index 5d46dc9..09cfb71 100644 --- a/fuzz/Cargo.lock +++ b/fuzz/Cargo.lock @@ -402,7 +402,7 @@ dependencies = [ [[package]] name = "kittyview" -version = "0.1.6" +version = "0.1.7" dependencies = [ "base64", "clap",