easyjump.yazi

A yazi plugin for quickly jumping to the visible files.

A bit like hop.nvim in Neovim but for yazi.

Tested on yazi nightly, stable, up to v25.5.31. The exact versions are visible in test.yml. Also see the yazi releases page.

Usage

Install the plugin. Choose your installation method:

ya pkg add mikavilpas/easyjump.yazi:easyjump

return {
  name = "easyjump.yazi",
  url = "https://github.com/mikavilpas/easyjump.yazi",
  version = "*", -- use latest release
  lazy = true,
  build = function(plugin)
    require("yazi.plugin").build_plugin(plugin, { sub_dir = "easyjump.yazi" })
  end,
}

Configuration

Initialize the plugin

-- ~/.config/yazi/init.lua

-- use the default settings
require("easyjump"):setup()

-- or customize the settings
require("easyjump"):setup({
  icon_fg = "#94e2d5",      -- color for hint labels
  first_key_fg = "#45475a", -- color for first char of double-key hints
})

Custom hint keys

You can customize which keys are used for the jump hints:

-- ~/.config/yazi/init.lua

require("easyjump"):setup({
  -- example customization - you can choose your own keys
  first_keys = "asdfgercwtvxbq", -- 14 keys
  second_keys = "yuiophjklnm", -- 11 keys
})

How it works:

• Single labels = first_keys + second_keys (used when ≤25 files visible)
• Double labels = first_keys × second_keys (used when >25 files)

With the default 14 first_keys and 11 second_keys, you get 25 single labels and 154 double labels.

Important: first_keys and second_keys must not share any characters. If they overlap, an error notification is displayed and the defaults are used instead.

Keymap

Set a shortcut key to toggle easyjump mode. For example, set i:

# ~/.config/yazi/keymap.toml
[[manager.prepend_keymap]]
on   = [ "i" ]
run  = "plugin easyjump"
desc = "easyjump"

When you see a character (single or double) on the left side of the entry. Press the key of the character to jump to the corresponding entry.

Acknowledgements 🙏🏻

Originally developed by DreamMaoMao. The original version is hosted at https://gitee.com/DreamMaoMao/easyjump.yazi. I liked this plugin so much that I wanted to add tests and maintain it.