dotfiles/ranger/README.md

ranger

This directory tracks the ranger setup I actually use instead of storing a full copy of the packaged defaults.

Files

• rc.conf: minimal overrides on top of ranger's built-in defaults
• scope.sh: richer previews for images, video, PDF, archives, and text

Recommended packages on Arch Linux

sudo pacman -S --needed \
  ranger ueberzugpp chafa ffmpegthumbnailer mediainfo highlight atool \
  perl-image-exiftool w3m mpv trash-cli unrar poppler imagemagick bat jq file

Install

./scripts/install-ranger.sh

Useful options:

• ./scripts/install-ranger.sh --dry-run
• ./scripts/install-ranger.sh --copy
• ./scripts/install-ranger.sh --target-dir ~/.config/ranger

Notes

• preview_images_method ueberzug works well in X11 terminals such as Alacritty.
• chafa provides a readable fallback when graphical image previews are unavailable.
• trash-cli powers the dt and dT key bindings in rc.conf.
• Existing rc.conf and scope.sh files are backed up under ~/.local/state/dotfiles-backups/ranger/.