You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
first of all, thanks for this great project — I really love the idea of viewing PDFs directly in the terminal with Kitty’s image protocol.
However, I’m running into an issue when trying to use fancy-cat inside tmux. When I run it, I immediately get the following error: error: NoGraphicsCapability
Outside of tmux, fancy-cat works perfectly fine. Inside tmux, it consistently fails with this error. I suspect it might be related to how tmux handles the Kitty graphics protocol, but I’m not sure.
Terminal: kitty 0.42.1
Tmux version: tmux 3.5a
OS: macOS Sequoia 15.5 arm64
Let me know if I can provide more information to help debug this.
Thanks again!
As far as I understand, the allow-passthrough option doesn't actually do anything by itself. It just permits an application to use the tmux passthrough sequence to communicate directly with the connected terminal. So if your app hasn't actually been designed to make use of that tmux sequence, it's not going to help.
Hi!
Sorry if this is a noob question, but how do I go about intalling your fork of the fancy-cat plugin? I am using tmux myself and would like to get this to work : )
Thanks!
@steinbrueckri I tried checkout the feature/tmux-support branch then doing the steps from the Build section, but I get the same error, do I need to uninstall the first install from brew or is there another way to ensure I install the feature tmux-support?
@vernalan There hasn't been any progress on this branch, its a very janky version atm, I'd call it unusable. I haven't gotten it to work consistently across multiple terminal emulators (Kitty, Ghostty, Wez).
@Lima98 Can you post the build error you're getting when you do zig build?
@freref
Here's what I've done. Using kitty terminal and tmux.
Cloned the repo, checkout feature/tmux-support. Then ran the commands in the build section:
git submodule update --init --recursive // No error as fast as as I could see.
zig build --release=small // No errors that I could see. Only an error: ld: warning: -s is obsolete
mv zig-out/bin/fancy-cat /usr/local/bin/ // No error
When running fancy-cat work.pdf in tmux I get:
info(vaxis): kitty graphics capability detected
and the screen is just blank.
I don't know if things have changed in the background, but I was able to successfully compile and use the tmux-support branch. Specifically, I was able to view pdf's on ghostty+tmux both on a local machine and across ssh (in a remote tmux session). The only issues that seem to remain are the log messages covering up some of the statusbar and the pdf stays visible on the terminal after the viewer is closed (though I can just type "clear" and it goes away).
I did test on kitty, but like @Lima98 I just get a black screen (but at least ghostty works!). Could some clarification be given on what are the major stoppers for getting this working smoothly for general use?
Version Info:
tmux: 3.6a
ghostty: 1.3.0-r71.ga0d3566-1-arch
Activity
freref commentedon Jun 28, 2025
Hi! This is a known issue with tmux. Can you try this workaround?
steinbrueckri commentedon Jun 28, 2025
noop 😭
j4james commentedon Jun 28, 2025
As far as I understand, the
allow-passthroughoption doesn't actually do anything by itself. It just permits an application to use the tmux passthrough sequence to communicate directly with the connected terminal. So if your app hasn't actually been designed to make use of that tmux sequence, it's not going to help.freref commentedon Jun 30, 2025
Thanks for trying, I don't use tmux myself, but I'll add this to my todo.
freref commentedon Oct 22, 2025
Adding tmux support is not as trivial as I expected. I've started work here rockorager/libvaxis#260.
freref commentedon Oct 23, 2025
Will be testing in this branch https://github.com/freref/fancy-cat/tree/feature/tmux-support.

vernalan commentedon Feb 1, 2026
Any update on this?
Lima98 commentedon Feb 11, 2026
Hi!
Sorry if this is a noob question, but how do I go about intalling your fork of the fancy-cat plugin? I am using tmux myself and would like to get this to work : )
Thanks!
steinbrueckri commentedon Feb 11, 2026
@Lima98 you need to build is on your own, see https://github.com/freref/fancy-cat?tab=readme-ov-file#build
Lima98 commentedon Feb 11, 2026
@steinbrueckri I tried checkout the feature/tmux-support branch then doing the steps from the Build section, but I get the same error, do I need to uninstall the first install from brew or is there another way to ensure I install the feature tmux-support?
freref commentedon Feb 11, 2026
@vernalan There hasn't been any progress on this branch, its a very janky version atm, I'd call it unusable. I haven't gotten it to work consistently across multiple terminal emulators (Kitty, Ghostty, Wez).
@Lima98 Can you post the build error you're getting when you do
zig build?freref commentedon Feb 11, 2026
What terminals are you guys using? Is anyone using the
tmux-supportbranch atm?Lima98 commentedon Feb 12, 2026
@freref
Here's what I've done. Using kitty terminal and tmux.
Cloned the repo, checkout feature/tmux-support. Then ran the commands in the build section:
git submodule update --init --recursive // No error as fast as as I could see.
zig build --release=small // No errors that I could see. Only an error: ld: warning: -s is obsolete
mv zig-out/bin/fancy-cat /usr/local/bin/ // No error
When running fancy-cat work.pdf in tmux I get:
info(vaxis): kitty graphics capability detected
and the screen is just blank.
UnsaltedScholar commentedon Mar 12, 2026
Greetings,
I don't know if things have changed in the background, but I was able to successfully compile and use the tmux-support branch. Specifically, I was able to view pdf's on ghostty+tmux both on a local machine and across ssh (in a remote tmux session). The only issues that seem to remain are the log messages covering up some of the statusbar and the pdf stays visible on the terminal after the viewer is closed (though I can just type "clear" and it goes away).
I did test on kitty, but like @Lima98 I just get a black screen (but at least ghostty works!). Could some clarification be given on what are the major stoppers for getting this working smoothly for general use?
Version Info:
tmux: 3.6a
ghostty: 1.3.0-r71.ga0d3566-1-arch
UnsaltedScholar commentedon Aug 13, 2026
Potentially relevant PR on tmux's side:
tmux/tmux#5445