mirror of https://github.com/jchook/ranger-zoxide.git synced 2025-12-26 18:34:56 +08:00

Easily jump between common directories in ranger

Find a file

Wes Roberts dbcf49dab2 Instructions for installing without git		2021-06-05 17:32:40 -04:00
__init__.py	Rename zoxide.py to __init__.py for easy install and update	2021-06-04 21:08:42 -04:00
LICENSE.md	Initial commit	2020-11-01 18:44:43 -05:00
README.md	Instructions for installing without git	2021-06-05 17:32:40 -04:00

README.md

ranger-zoxide

A zoxide (aka z) plugin for ranger.

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

:z <partial-name>

Features

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

Install via Git

Clone this repository into your ~/.config/ranger/plugins folder. For example:

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

Install without Git

For ranger versions older than 1.9.3, or to install without Git, simply 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

License

MIT