Ranger & z

July 27, 2026 ยท View on GitHub

This plugin integrates z with ranger. It uses the .z database to enable quick directory jumping inside ranger. You can watch a demo in this screencast.

Note: This branch supports only z. If you want to use zsh-z, see the master branch.

Requirements

  • Set the _Z_SRC environment variable to the path of z.sh.

Installation

cd "${XDG_CONFIG_HOME:-$HOME/.config}/ranger/plugins"
git clone https://github.com/ask1234560/ranger-zjumper.git

echo -e "# z jumper\nmap cz console z%space" >> "${XDG_CONFIG_HOME:-$HOME/.config}"/ranger/rc.conf

Restart ranger after installation.

Usage

  • Run :z dir to jump to directory.
  • Alternatively:
    • Press c, then z, then type your directory query.

Updating

To update the plugin:

cd "${XDG_CONFIG_HOME:-$HOME/.config}/ranger/plugins/ranger-zjumper"
git pull

See Also