mirror of
https://github.com/jchook/ranger-zoxide.git
synced 2025-12-26 18:34:56 +08:00
64 lines
1.3 KiB
Markdown
64 lines
1.3 KiB
Markdown
# ranger-zoxide
|
|
|
|
A [`zoxide`](https://github.com/ajeetdsouza/zoxide) (aka `z`) plugin for
|
|
[`ranger`](https://github.com/ranger/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:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
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](https://github.com/ask1234560/ranger-zjumper).
|
|
|
|
## License
|
|
|
|
MIT
|