Keybindings

This is a comprehensive reference of all default keybindings in Yazi, extracted from the source code.

All keybindings can be customized in ~/.config/yazi/keymap.toml. This reference shows the default configuration.

Manager (File Browser)

The main file manager interface keybindings.

Quit and Exit

Key	Command	Description
`q`	`quit`	Quit Yazi
`Q`	`quit --no-cwd-file`	Quit without writing cwd-file
`<C-c>`	`close`	Close current tab (or quit if last)
`<C-z>`	`suspend`	Suspend the process
`<Esc>`	`escape`	Exit visual mode, clear selection, or cancel search
`<C-[>`	`escape`	Same as Esc

Key	Command	Description
`k` / `<Up>`	`arrow prev`	Move to previous file
`j` / `<Down>`	`arrow next`	Move to next file
`gg`	`arrow top`	Jump to top of list
`G`	`arrow bot`	Jump to bottom of list
`<C-u>` / `<S-PageUp>`	`arrow -50%`	Move up half page
`<C-d>` / `<S-PageDown>`	`arrow 50%`	Move down half page
`<C-b>` / `<PageUp>`	`arrow -100%`	Move up one page
`<C-f>` / `<PageDown>`	`arrow 100%`	Move down one page

Key	Command	Description
`h` / `<Left>`	`leave`	Go to parent directory
`l` / `<Right>`	`enter`	Enter child directory
`H`	`back`	Go back in history
`L`	`forward`	Go forward in history

Selection and Visual Mode

Key	Command	Description
`<Space>`	`toggle`, `arrow 1`	Toggle selection and move down
`<C-a>`	`toggle_all --state=on`	Select all files
`<C-r>`	`toggle_all`	Invert selection
`v`	`visual_mode`	Enter visual mode (select)
`V`	`visual_mode --unset`	Enter visual mode (unset)

Preview

Key	Command	Description
`J`	`seek 5`	Seek down 5 units in preview
`K`	`seek -5`	Seek up 5 units in preview
`<Tab>`	`spot`	Toggle spot mode

File Operations

Key	Command	Description
`o` / `<Enter>`	`open`	Open selected files
`O` / `<S-Enter>`	`open --interactive`	Open interactively
`y`	`yank`	Yank (copy) selected files
`x`	`yank --cut`	Cut selected files
`p`	`paste`	Paste yanked files
`P`	`paste --force`	Paste and overwrite
`-`	`link`	Create symbolic link (absolute)
`_`	`link --relative`	Create symbolic link (relative)
`<C-->`	`hardlink`	Create hard link
`Y` / `X`	`unyank`	Cancel yank status
`d`	`remove`	Move to trash
`D`	`remove --permanently`	Delete permanently
`a`	`create`	Create file or directory
`r`	`rename --cursor=before_ext`	Rename file

Shell and Commands

Key	Command	Description
`;`	`shell --interactive`	Run shell command
`:`	`shell --block --interactive`	Run shell command (blocking)
`.`	`hidden toggle`	Toggle hidden files

Search and Filter

Key	Command	Description
`s`	`search --via=fd`	Search files by name (fd)
`S`	`search --via=rg`	Search by content (ripgrep)
`<C-s>`	`escape --search`	Cancel ongoing search
`z`	`plugin fzf`	Jump with fzf
`Z`	`plugin zoxide`	Jump with zoxide
`f`	`filter --smart`	Filter files
`/`	`find --smart`	Find next file
`?`	`find --previous --smart`	Find previous file
`n`	`find_arrow`	Jump to next found
`N`	`find_arrow --previous`	Jump to previous found

Copy Path/Name

Key	Command	Description
`cc`	`copy path`	Copy file path
`cd`	`copy dirname`	Copy directory path
`cf`	`copy filename`	Copy filename
`cn`	`copy name_without_ext`	Copy name without extension

Linemode

Key	Command	Description
`ms`	`linemode size`	Show file sizes
`mp`	`linemode permissions`	Show permissions
`mb`	`linemode btime`	Show birth time
`mm`	`linemode mtime`	Show modification time
`mo`	`linemode owner`	Show file owner
`mn`	`linemode none`	Hide extra info

Sorting

Key	Command	Description
`,m`	`sort mtime --reverse=no`	Sort by modified time
`,M`	`sort mtime --reverse=yes`	Sort by modified time (reverse)
`,b`	`sort btime --reverse=no`	Sort by birth time
`,B`	`sort btime --reverse=yes`	Sort by birth time (reverse)
`,e`	`sort extension --reverse=no`	Sort by extension
`,E`	`sort extension --reverse=yes`	Sort by extension (reverse)
`,a`	`sort alphabetical --reverse=no`	Sort alphabetically
`,A`	`sort alphabetical --reverse=yes`	Sort alphabetically (reverse)
`,n`	`sort natural --reverse=no`	Sort naturally
`,N`	`sort natural --reverse=yes`	Sort naturally (reverse)
`,s`	`sort size --reverse=no`	Sort by size
`,S`	`sort size --reverse=yes`	Sort by size (reverse)
`,r`	`sort random --reverse=no`	Sort randomly

Goto

Key	Command	Description
`gh`	`cd ~`	Go to home directory
`gc`	`cd ~/.config`	Go to config directory
`gd`	`cd ~/Downloads`	Go to Downloads
`g<Space>`	`cd --interactive`	Interactive directory jump
`gf`	`follow`	Follow symlink

Tabs

Key	Command	Description
`tt`	`tab_create --current`	Create tab in CWD
`tr`	`tab_rename --interactive`	Rename current tab
`1`	`tab_switch 0`	Switch to tab 1
`2`	`tab_switch 1`	Switch to tab 2
`3`	`tab_switch 2`	Switch to tab 3
`4`	`tab_switch 3`	Switch to tab 4
`5`	`tab_switch 4`	Switch to tab 5
`6`	`tab_switch 5`	Switch to tab 6
`7`	`tab_switch 6`	Switch to tab 7
`8`	`tab_switch 7`	Switch to tab 8
`9`	`tab_switch 8`	Switch to tab 9
`[`	`tab_switch -1 --relative`	Previous tab
`]`	`tab_switch 1 --relative`	Next tab
`{`	`tab_swap -1`	Swap with previous tab
`}`	`tab_swap 1`	Swap with next tab

Tasks and Help

Key	Command	Description
`w`	`tasks:show`	Show task manager
`~` / `<F1>`	`help`	Open help

Input Mode

Keybindings for text input (rename, create, shell, etc.).

Mode Switching

Key	Command	Description
`i`	`insert`	Enter insert mode
`I`	`move first-char`, `insert`	Move to BOL and insert
`a`	`insert --append`	Enter append mode
`A`	`move eol`, `insert --append`	Move to EOL and append
`v`	`visual`	Enter visual mode
`r`	`replace`	Replace single character

Key	Command	Description
`h` / `<Left>` / `<C-b>`	`move -1`	Move back one character
`l` / `<Right>` / `<C-f>`	`move 1`	Move forward one character
`b` / `<A-b>` / `<C-Left>`	`backward`	Move to start of word
`w`	`forward`	Move to start of next word
`e` / `<A-f>` / `<C-Right>`	`forward --end-of-word`	Move to end of word
`0` / `<C-a>` / `<Home>`	`move bol`	Move to beginning of line
`$` / `<C-e>` / `<End>`	`move eol`	Move to end of line
`^` / `_`	`move first-char`	Move to first non-whitespace

Editing

Key	Command	Description
`<Backspace>` / `<C-h>`	`backspace`	Delete previous character
`<Delete>` / `<C-d>`	`backspace --under`	Delete character under cursor
`<C-u>`	`kill bol`	Kill to beginning of line
`<C-k>`	`kill eol`	Kill to end of line
`<C-w>` / `<C-Backspace>`	`kill backward`	Kill previous word
`<A-d>` / `<C-Delete>`	`kill forward`	Kill next word

Cut/Copy/Paste

Key	Command	Description
`d`	`delete --cut`	Cut selection
`D`	`delete --cut`, `move eol`	Cut to EOL
`c`	`delete --cut --insert`	Cut and insert
`x`	`delete --cut`, `move 1`	Cut character
`y`	`yank`	Copy selection
`p`	`paste`	Paste after cursor
`P`	`paste --before`	Paste before cursor

Undo/Redo

Key	Command	Description
`u`	`undo`, `casefy lower`	Undo (or lowercase in visual)
`U`	`casefy upper`	Uppercase
`<C-r>`	`redo`	Redo

Submit/Cancel

Key	Command	Description
`<Enter>`	`close --submit`	Submit input
`<C-c>`	`close`	Cancel input
`<Esc>` / `<C-[>`	`escape`	Back to normal or cancel

Tasks Manager

Key	Command	Description
`<Esc>` / `<C-[>` / `<C-c>` / `w`	`close`	Close task manager
`k` / `<Up>`	`arrow prev`	Previous task
`j` / `<Down>`	`arrow next`	Next task
`<Enter>`	`inspect`	Inspect task
`x`	`cancel`	Cancel task
`~` / `<F1>`	`help`	Open help

Spot Mode

Key	Command	Description
`<Esc>` / `<C-[>` / `<C-c>` / `<Tab>`	`close`	Close spot
`k` / `<Up>`	`arrow prev`	Previous line
`j` / `<Down>`	`arrow next`	Next line
`h` / `<Left>`	`swipe prev`	Previous file
`l` / `<Right>`	`swipe next`	Next file
`cc`	`copy cell`	Copy selected cell
`~` / `<F1>`	`help`	Open help

Pick/Select Mode

Key	Command	Description
`<Esc>` / `<C-[>` / `<C-c>`	`close`	Cancel pick
`<Enter>`	`close --submit`	Submit selection
`k` / `<Up>`	`arrow prev`	Previous option
`j` / `<Down>`	`arrow next`	Next option
`~` / `<F1>`	`help`	Open help

Confirm Dialog

Key	Command	Description
`<Esc>` / `<C-[>` / `<C-c>` / `n`	`close`	Cancel
`<Enter>` / `y`	`close --submit`	Confirm
`k` / `<Up>`	`arrow prev`	Previous option
`j` / `<Down>`	`arrow next`	Next option
`~` / `<F1>`	`help`	Open help

Key	Command	Description
`<C-c>`	`close`	Cancel completion
`<Tab>`	`close --submit`	Accept completion
`<Enter>`	`close --submit`, `input:close --submit`	Complete and submit
`<A-k>` / `<Up>` / `<C-p>`	`arrow prev`	Previous item
`<A-j>` / `<Down>` / `<C-n>`	`arrow next`	Next item
`~` / `<F1>`	`help`	Open help

Help Screen

Key	Command	Description
`<Esc>` / `<C-[>`	`escape`	Clear filter or hide help
`<C-c>`	`close`	Close help
`k` / `<Up>`	`arrow prev`	Scroll up
`j` / `<Down>`	`arrow next`	Scroll down
`f`	`filter`	Filter help items

Customization

To customize keybindings, create or edit ~/.config/yazi/keymap.toml:

# Example: Change navigation to arrow keys only
[mgr]
keymap = [
  { on = "<Up>",   run = "arrow prev", desc = "Move up" },
  { on = "<Down>", run = "arrow next", desc = "Move down" },
  # Add more custom bindings...
]

See the Configuration page for detailed information on customizing keybindings.

Source Reference

All default keybindings are defined in:

File: ~/workspace/source/yazi-config/preset/keymap-default.toml
Line reference: Various sections throughout the file

The keybindings are processed by the Yazi core and can be overridden in your user configuration.

Get Started

Usage

Configuration

Features

Plugins

Keybindings

Manager (File Browser)

Quit and Exit

Navigation - Vertical

Navigation - Horizontal

Selection and Visual Mode

Preview

File Operations

Shell and Commands

Search and Filter

Copy Path/Name

Linemode

Sorting

Goto

Tabs

Tasks and Help

Input Mode

Mode Switching

Navigation

Editing

Cut/Copy/Paste

Undo/Redo

Submit/Cancel

Tasks Manager

Spot Mode

Pick/Select Mode

Confirm Dialog

Completion Menu

Help Screen

Customization

Source Reference

Build docs developers (and LLMs) love

Get Started

Usage

Configuration

Features

Plugins

Documentation Index

​Manager (File Browser)

​Quit and Exit

​Navigation - Vertical

​Navigation - Horizontal

​Selection and Visual Mode

​Preview

​File Operations

​Shell and Commands

​Search and Filter

​Copy Path/Name

​Linemode

​Sorting

​Goto

​Tabs

​Tasks and Help

​Input Mode

​Mode Switching

​Navigation

​Editing

​Cut/Copy/Paste

​Undo/Redo

​Submit/Cancel

​Tasks Manager

​Spot Mode

​Pick/Select Mode

​Confirm Dialog

​Completion Menu

​Help Screen

​Customization

​Source Reference

Build docs developers (and LLMs) love

Manager (File Browser)

Quit and Exit

Navigation - Vertical

Navigation - Horizontal

Selection and Visual Mode

Preview

File Operations

Shell and Commands

Search and Filter

Copy Path/Name

Linemode

Sorting

Goto

Tabs

Tasks and Help

Input Mode

Mode Switching

Navigation

Editing

Cut/Copy/Paste

Undo/Redo

Submit/Cancel

Tasks Manager

Spot Mode

Pick/Select Mode

Confirm Dialog

Completion Menu

Help Screen

Customization

Source Reference