Keybindings

Complete default keybinding reference for Yazi

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

Navigation - Vertical

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

Navigation - Horizontal

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

Navigation

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

Completion Menu

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.