#2414·ranger

Ranger Freezes when trying to display an image (Using Kitty with Tmux)

Author: ricesetCreated Aug 11, 2021Updated Aug 9, 2026
Labelsbugimage-previewhelp-wanted

Runtime Environment

  • Operating system and version: MacOS Big Sur 11.5.1
  • Terminal emulator and version: Kitty 0.22.2
  • Python version: 3.6.12
  • Ranger version/commit: 1.9.3
  • Locale: en_US.UTF-8

Current Behavior

The application completely freezes when trying to display an image.

Possible Solutions

It probably has to do with Tmux because it works normally without it. edit: I tested it now without using Tmux and it displays the image but, after opening it using MacOS's Preview (by pressing l) when I go back to Ranger, it gets frozen again and I have to close my terminal window.

Steps to reproduce

  1. Open kitty
  2. Open Tmux
  3. Open Ranger
  4. Try viewing an image

rc.config contents

set preview_images true
set preview_images_method kitty