FAQs

What about Windows support?

• Firstly, only the new Windows Terminal seems to have proper truecolor support and modern terminal emulator features.

• The CLI mode currently works (with a few quirks), i.e using cmd or powershell, if the other requirements are satisfied but can’t guarantee it’ll always be so.

  • Drawing images and animations doesn’t work completely well in cmd and powershell. See the library's Known Issues for details.

• The TUI doesn’t work due to the lack of fcntl on Windows, which is used by urwid.

• If stuck on Windows and want to use all features, you could use WSL + Windows Terminal.

Why are colours not properly reproduced?

• Some terminals support truecolor escape sequences but have a 256-color palette. This limits color reproduction.

Why are images out of scale?

• If auto cell ratio is supported and enabled,

  • Use swap win size or --swap-win-size.

  • If the above doesn’t work, then open a new issue here with adequate details.

• Otherwise,

  • Adjust the cell ratio using cell ratio or -C.

Why is the TUI unresponsive or slow in drawing images?

• Drawing (not rendering) speed is entirely dependent on the terminal emulator itself.

• Some terminal emulators block upon input, so rapidly repeated input could cause the terminal to be unresponsive.