Skip to content

Tmux - error: NoGraphicsCapability #84

Open

Description

@steinbrueckri

Hi,

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!

Activity

  1. freref commented on Jun 28, 2025

    @freref
    Owner

    Hi! This is a known issue with tmux. Can you try this workaround?

  2. steinbrueckri commented on Jun 28, 2025

    @steinbrueckri
    Author

    noop 😭

    Image
  3. j4james commented on Jun 28, 2025

    @j4james

    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.

  4. freref commented on Jun 30, 2025

    @freref
    Owner

    Thanks for trying, I don't use tmux myself, but I'll add this to my todo.

  5. freref commented on Oct 22, 2025

    @freref
    Owner

    Adding tmux support is not as trivial as I expected. I've started work here rockorager/libvaxis#260.

  6. freref commented on Oct 23, 2025

    @freref
    Owner
  7. vernalan commented on Feb 1, 2026

    @vernalan

    Any update on this?

  8. Lima98 commented on Feb 11, 2026

    @Lima98

    Will be testing in this branch https://github.com/freref/fancy-cat/tree/feature/tmux-support. Image

    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!

  9. steinbrueckri commented on Feb 11, 2026

    @steinbrueckri
    Author
  10. Lima98 commented on Feb 11, 2026

    @Lima98

    @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?

  11. freref commented on Feb 11, 2026

    @freref
    Owner

    @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?

  12. freref commented on Feb 11, 2026

    @freref
    Owner

    What terminals are you guys using? Is anyone using the tmux-support branch atm?

  13. Lima98 commented on Feb 12, 2026

    @Lima98

    @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.

  14. UnsaltedScholar commented on Mar 12, 2026

    @UnsaltedScholar

    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

  15. UnsaltedScholar commented on Aug 13, 2026

    @UnsaltedScholar

    Potentially relevant PR on tmux's side:
    tmux/tmux#5445

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions