---

Basic Navigation

File Navigation

• h or ← - Go to parent directory

• l or → or Enter - Enter directory / Open file

• j or ↓ - Move down

• k or ↑ - Move up

• gg - Go to top

• G - Go to bottom

• Ctrl+d - Scroll down half page

• Ctrl+u - Scroll up half page

• Ctrl+f - Scroll down full page

• Ctrl+b - Scroll up full page

• Home - Go to first file

• End - Go to last file

Quick Navigation

• ~ - Go to home directory

• - - Go to previous directory

• , - Go to previous directory (alternative)

• . - Toggle hidden files

• z - Go to parent directory

• Z - Go to previous directory

---

File Operations

Selection

• Space - Toggle selection

• v - Toggle selection (alternative)

• a - Select all

• A - Deselect all

• * - Invert selection

• ; - Select by pattern

• : - Deselect by pattern

Copy/Move/Delete

• y - Copy selected files

• x - Cut selected files

• p - Paste files

• P - Paste files (with overwrite prompt)

• d - Delete selected files

• D - Delete permanently (bypass trash)

• r - Rename file

• R - Bulk rename

• c - Copy file path

• C - Copy file name

• Y - Copy file path (absolute)

Create

• n - Create new file

• N - Create new directory

• m - Create new file (with prompt)

• M - Create new directory (with prompt)

---

Viewing and Opening

Viewing

• o - Open file (system default)

• O - Open file (with application selector)

• e - Open file in editor

• E - Open file in editor (with editor selector)

• w - Open file in preview

• W - Toggle preview

• i - Show file information

• I - Show file information (detailed)

• u - Show file URL

• U - Copy file URL

Preview

• w - Toggle preview

• W - Toggle preview (alternative)

• p - Toggle preview (alternative)

• P - Toggle preview (alternative)

---

Search and Filter

Search

• / - Search files

• ? - Search files (backward)

• n - Next match

• N - Previous match

• Esc - Clear search

Filter

• f - Filter files

• F - Filter files (case sensitive)

• Esc - Clear filter

Find

• ; - Find file by name

• : - Find file by name (backward)

---

Tabs and Windows

Tabs

• t - New tab

• T - New tab (with path)

• [ - Previous tab

• ] - Next tab

• { - Move tab left

• } - Move tab right

• q - Close tab

• Q - Close all tabs except current

Windows

• Tab - Switch between panes

• Ctrl+w - Close pane

• Ctrl+n - New pane

• Ctrl+h - Focus left pane

• Ctrl+j - Focus bottom pane

• Ctrl+k - Focus top pane

• Ctrl+l - Focus right pane

• H - Resize pane left

• J - Resize pane down

• K - Resize pane up

• L - Resize pane right

• = - Equalize pane sizes

---

Sorting and Display

Sorting

• s - Sort by name

• S - Sort by size

• t - Sort by modified time

• T - Sort by created time

• e - Sort by extension

• E - Sort by extension (reverse)

• r - Reverse sort order

• R - Toggle sort order

Display

• . - Toggle hidden files

• z - Toggle file size display

• Z - Toggle file size display (alternative)

• : - Toggle line numbers

• ; - Toggle line numbers (alternative)

---

Advanced Operations

Archive Operations

• a - Create archive

• A - Extract archive

• e - Extract archive (with prompt)

Git Operations

• g - Show git status

• G - Show git log

• b - Show git branches

• B - Show git branches (alternative)

System Operations

• ! - Execute shell command

• $ - Execute shell command (with output)

• & - Execute shell command (background)

• @ - Execute shell command (with prompt)

Other Operations

• u - Undo last operation

• U - Redo last operation

• r - Refresh directory

• R - Reload configuration

• : - Command mode

• Esc - Cancel operation

• Ctrl+c - Cancel operation (alternative)

---

Command Mode

• : - Enter command mode

• cd <path> - Change directory

• open <path> - Open path

• quit or q - Quit

• exit - Exit

• help - Show help

• version - Show version

• config - Open config file

• theme - Change theme

• plugin - Manage plugins

---

Configuration

Key Locations

• ~/.config/yazi/yazi.toml - Main config

• ~/.config/yazi/keymap.toml - Key bindings

• ~/.config/yazi/theme.toml - Theme config

• ~/.config/yazi/plugins/ - Plugins directory

Common Settings (yazi.toml)

[manager]
sort_by = "alphabetical"
sort_sensitive = true
sort_reverse = false
sort_dir_first = true
linemode = "none"
show_hidden = false
show_symlink = true
scrolloff = 5
mouse_enabled = true

[preview]
tab_size = 2
max_width = 600
max_height = 900
image_quality = 75

Common Key Bindings (keymap.toml)

[manager]
keymap = [
  { on = [ "<Enter>", "l" ], run = "open", desc = "Open file or enter directory" },
  { on = [ "h", "<Left>" ], run = "leave", desc = "Go to parent directory" },
  { on = [ "j", "<Down>" ], run = "move", desc = "Move down" },
  { on = [ "k", "<Up>" ], run = "move", desc = "Move up" },
  { on = [ "gg" ], run = "go 0", desc = "Go to top" },
  { on = [ "G" ], run = "go -1", desc = "Go to bottom" },
  { on = [ "<Space>" ], run = "select --toggle", desc = "Toggle selection" },
  { on = [ "y" ], run = "copy", desc = "Copy files" },
  { on = [ "x" ], run = "cut", desc = "Cut files" },
  { on = [ "p" ], run = "paste", desc = "Paste files" },
  { on = [ "d" ], run = "remove", desc = "Delete files" },
  { on = [ "r" ], run = "rename", desc = "Rename file" },
  { on = [ "n" ], run = "create", desc = "Create file" },
  { on = [ "N" ], run = "create --dir", desc = "Create directory" },
  { on = [ "/" ], run = "search", desc = "Search files" },
  { on = [ "f" ], run = "filter", desc = "Filter files" },
  { on = [ "t" ], run = "tab_create", desc = "Create tab" },
  { on = [ "q" ], run = "tab_close", desc = "Close tab" },
]

---

Tips

• Use :help for help

• Use :config to open config file

• Use :theme to change theme

• Use Ctrl+c to cancel operations

• Use Esc to clear search/filter

• Use Space to select multiple files

• Use y then p to copy and paste files

• Use x then p to cut and paste files

• Use / to search files quickly

• Use f to filter files

• Use t to create new tabs

• Use Tab to switch between panes

• Use . to toggle hidden files

• Use gg and G for quick navigation

• Use ~ to go to home directory

• Use - to go to previous directory

---