dotfiles/ranger/README.md

36 lines
1 KiB
Markdown

# 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
```bash
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
```bash
./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/`.