Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jchook/ranger-zoxide
Easily jump between common directories in ranger
https://github.com/jchook/ranger-zoxide
cli filesystem plugin ranger z
Last synced: about 23 hours ago
JSON representation
Easily jump between common directories in ranger
- Host: GitHub
- URL: https://github.com/jchook/ranger-zoxide
- Owner: jchook
- License: mit
- Created: 2020-11-01T23:43:16.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-02-08T08:18:31.000Z (9 months ago)
- Last Synced: 2024-08-03T18:21:09.885Z (3 months ago)
- Topics: cli, filesystem, plugin, ranger, z
- Language: Python
- Homepage:
- Size: 13.7 KB
- Stars: 106
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- ranger-awesome - ranger-zoxide
README
# 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
```
Or use interactive mode:
```
:zi
```
## 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 [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:
```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