/ranger-zoxide

Easily jump between common directories in ranger

Primary LanguagePythonMIT LicenseMIT

ranger-zoxide

A zoxide (aka z) plugin for ranger.

Easily jump between commonly visited directories by running this in ranger:

:z <partial-name>

Or use interactive mode:

:zi <partial-name>

Features

  • Very simple & fast thanks to zoxide
  • Supports tab completion
  • Works with Python >= 2.7, or >= 3.1

Install

For ranger >= 1.9.3, use Git to clone this repository into your ~/.config/ranger/plugins folder. For example:

git clone git@github.com:jchook/ranger-zoxide.git ~/.config/ranger/plugins/zoxide

Legacy Install

For ranger versions older than 1.9.3, or to install without Git, download __init__.py to your ~/.config/ranger/plugins directory. For example:

mkdir -p ~/.config/ranger/plugins
wget -O ~/.config/ranger/plugins/zoxide.py https://raw.githubusercontent.com/jchook/ranger-zoxide/master/zoxide.py

Keyboard Shortcut

You may wish to add a keyboard shortcut to quickly z between common directories. Simply add a binding to your ~/.config/ranger/rc.conf file:

map cz console z%space

Or for interactive use:

map cz zi

See Also

License

MIT