From 523ca15a3b4882a4e49eb4736cc2d5d11b8df9a7 Mon Sep 17 00:00:00 2001 From: Bence Ferdinandy Date: Wed, 13 Mar 2024 13:56:54 +0100 Subject: docs: update filter tips for images Since aerc uses vaxis, the image/* filter has incorrect information. Update this with the new behaviour. Fixes: 4e26faf498b8 ("msgviewer: implement inline image viewing") Signed-off-by: Bence Ferdinandy Reviewed-by: Inwit Acked-by: Robin Jarry --- doc/aerc-config.5.scd | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd index ea931675..b26d7695 100644 --- a/doc/aerc-config.5.scd +++ b/doc/aerc-config.5.scd @@ -1064,15 +1064,17 @@ _application/pdf_ https://www.xpdfreader.com/pdftotext-man.html _image/\*_ + This is a tricky topic. It's possible to display images in a terminal, but for high resolution images the terminal you are using either needs - to support sixels or the kitty terminal graphics protocol. - Unfortunately, aerc's built-in terminal supports neither, so only highly - pixelated images can be shown natively. A workaround is possible by - asking the terminal to draw on top of aerc and then remove the image - when done viewing. - - The built-in terminal can show pixelated images with *catimg*(1): + to support sixels or the kitty terminal graphics protocol. The built-in + terminal emulator of aerc (via the TUI library Vaxis) supports both. + Furthermore if you don't set any filter for images, Vaxis will figure + out what your terminal emulator supports and either use sixels, kitty + graphics, or fall back to a pixelated half-block. You can turn this + feature off, by setting a filter that is essentially no-op. + + You can still set a specific filter, e.g *catimg*(1): ``` image/\*=catimg -w$(tput cols) - -- cgit