jchook/ranger-zoxide

Easily jump between common directories in ranger

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 [email protected]: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

• ranger-zjumper.

License

MIT

ranger-zoxide's Issues

Merge with another plugin?

Hi,

when I migrated to zoxide, I also migrated my old ranger-autojump plugin to ranger-zoxide. As you can guess, I now found your plugin, and I'm wondering if it makes sense to merge the two? The code differs just a bit, and mine also offers a zsh plugin to easily invoke ranger in a certain directory. What do you think?

mligy

[submodule ".config/ranger/plugins/zoxide"]
path = .config/ranger/plugins/zoxide
url = [email protected]:jchook/ranger-zoxide.git
[submodule ".hammerspoon/stackline"]
path = .hammerspoon/stackline
url = [email protected]:AdamWagner/stackline.git

Details

`--print0` in `_ZO_FZF_OPTS` will make zi unusable in ranger

Long time ago I posted an issue #10

then finally I know why it doesn't work.

I got set -gx _ZO_FZF_OPTS "-1 -0 --reverse --print0" in my fish shell config

and I found that --print0 will make the zi unusable in ranger.

Add .gitignore file that ignores the __pycache__ directory #11

When using plugins by cloning their repos into Ranger's plugins folder, a directory named __pycache__ is created. Since it is currently not ignored, git thinks that my local copy of the ranger-zoxide repo has been modified. This isn't a very big problem, but it is somewhat annoying and I would appreciate a .gitignore file that ignores __pycache__.

Provide configuration option for command name

I prefer :j over :z to trigger Zoxide and would like to be able to configure the command in some way. Zoxide also allows to configure the command with zoxide init --cmd j.

I could try to implement it if there's interest in it.

zi in ranger does not jump to directory

When I use :zi dir inside ranger, it uses the fzf to choose the right path, but after I hit Enter, it doesn't jump to the directory.

zi inside my shell works OK.

Cannot cd to a directory that exists but not in the zoxide database

The original zoxide can cd to a directory that does not exist in the database if the path is valid, but this cannot.

Consider renaming zoxide.py to __init__.py

Hey, thanks for maintaining ranger-zoxide!

Ranger now supports plugin directories, allowing one to simply clone entire Git repositories straight into your plugin directory. This makes both installating and updating plugins a lot easier.

For this, your directory needs to be a proper Python package -- to do this, you can simply rename zoxide.py to __init__.py.