Upgrading

Outdated configuration files?

When upgrading to a new minor version (e.g. from 1.6.1 to 1.7.0), there may be incompatibilities in the configuration files. To find out if that is the case, run

ranger --clean

If ranger now works for you, it means you need to update your configuration. It's located at ~/.config/ranger/ and consists of the files rc.conf, commands.py, scope.sh and rifle.conf. To update them, simply deleting them should suffice, because then the default ones will be used. If you have customized them, you need to merge them manually with the new default configs.

Image previews stopped working after updating ranger-git

In September 2015, there was a backwards-incompatible change of scope.sh which broke image previewing. To fix this, rename/delete your old ~/.config/ranger/scope.sh, run ranger --copy-config=scope and, if necessary, merge your changes to scope.sh into the new version.