Fix: preview_images_method: switch to ueberzug

diff --git a/config.dot/ranger/rc.conf.link b/config.dot/ranger/rc.conf.link
index b33a6e919986ea593f5aea3f8f37c75da5270895..6f4aa91f5f85e5eb2d441af8832de9acc15d917d 100644 (file)
--- a/config.dot/ranger/rc.conf.link
+++ b/config.dot/ranger/rc.conf.link
@@ -5,13 +5,31 @@
 set colorscheme solarized
 
 # Previews
-# See https://github.com/ranger/ranger/wiki/Image-Previews
-#     https://github.com/ranger/ranger/wiki/Video-Previews
+#
+# Details at https://github.com/ranger/ranger/wiki/Image-Previews
+#            https://github.com/ranger/ranger/wiki/Video-Previews
+#
+# The default w3m method does not work with Alacritty.
+# The alternative ueberzug does work with Alacritty, but only
+# on Xorg (not on Wayland). Details at
+# https://github.com/alacritty/alacritty/issues/1021
+#
+# Other options (not available in Debian, as of 2025-12):
+# https://github.com/atanunq/viu
+# https://github.com/jstkdng/ueberzugpp
+#
+# Additional references:
+# https://github-wiki-see.page/m/ranger/ranger/wiki/Image-Previews
+#
 set preview_files true
 set preview_images true
 set use_preview_script true
 #set preview_images_method urxvt
 #set preview_images_method mpv
+#set preview_images_method w3m
+#set preview_images_method viu
+#set preview_images_method ueberzugpp
+set preview_images_method ueberzug
 set preview_script ~/.config/ranger/scope.sh
 
 # Line numbers

diff --git a/config.dot/ranger/scope.sh.link b/config.dot/ranger/scope.sh.link
index 704e9217f31ef0737ca2fb26fc47469915189d38..3d6a625357157b07718d0edd9276c849892a1996 100755 (executable)
--- a/config.dot/ranger/scope.sh.link
+++ b/config.dot/ranger/scope.sh.link
@@ -119,6 +119,7 @@ handle_image() {
         #     # Thumbnail
         #     ffmpegthumbnailer -i "${FILE_PATH}" -o "${IMAGE_CACHE_PATH}" -s 0 && exit 6
         #     exit 1;;
+
         # PDF
         # application/pdf)
         #     pdftoppm -f 1 -l 1 \
@@ -129,6 +130,7 @@ handle_image() {
         #              -- "${FILE_PATH}" "${IMAGE_CACHE_PATH%.*}" \
         #         && exit 6 || exit 1;;
 
+        # Compressed
         # Preview archives using the first image inside.
         # (Very useful for comic book collections for example.)
         # application/zip|application/x-rar|application/x-7z-compressed|\

diff --git a/dependencies/debian b/dependencies/debian
index 16104a13930205c12853b155404f4740769c05cd..efd7578782c3b42eb789780a318e2f713052b946 100644 (file)
--- a/dependencies/debian
+++ b/dependencies/debian
@@ -10,3 +10,5 @@ highlight
 # Media viewers
 feh
 sxiv
+w3m-img
+ueberzug