yazi/config/docs/keymap.md

# Keymap

## manager

- escape: Exit visual mode, clear selected, or cancel search.
- quit: Exit the process.
- close: Close the current tab; if it is the last tab, then exit the process.

### Navigation

- arrow

  - `n`: Move the cursor up or down by n lines. Use negative values to move up and positive values to move down.

- leave: Go back to the parent directory.
- enter: Enter the child directory.
- back: Go back to the previous directory.
- forward: Go forward to the next directory.
- peek

  - `n`: Peek up or down at file contents in the preview. Use negative values to peek up and positive values to peek down.

- cd: Change the current directory.

  - `path`: the path to change to.
  - `--interactive`: Use an interactive UI to input the path.

### Selection

- select

  - `--state=true`: Select the current file.
  - `--state=false`: Deselect the current file.
  - `--state=none`: Default, toggle the selection state of the current file.

- select_all

  - `--state=true`: Select all files.
  - `--state=false`: Deselect all files.
  - `--state=none`: Default, toggle the selection state of all files.

- visual_mode: Enter visual mode (selection mode).

  - `--unset`: Enter visual mode (unset mode).

### Operation

- open: Open the selected files.

  - `--interactive`: Open the selected files with an interactive UI to choose the opening method.

- yank: Copy the selected files.

  - `--cut`: Cut the selected files.

- paste: Paste the files.

  - `--force`: Overwrite the destination file if it exists.
  - `--follow`: Copy the file pointed to by a symbolic link, rather than the link itself. Only valid during copying.

- remove: Move the files to the trash/recycle bin.

  - `--force`: Don't show the confirmation dialog, and trash/delete the files directly.
  - `--permanently`: Permanently delete the files.

- create: Create a file or directory (ends with `/` for directories).
- rename: Rename a file or directory.
- copy: Copy the path of files or directories that are selected or hovered on.

  - `path`: Copy the absolute path.
  - `dirname`: Copy the path of the parent directory.
  - `filename`: Copy the name of the file.
  - `name_without_ext`: Copy the name of the file without the extension.

- shell: Run a shell command.

  - `exec`: Optional, command template to be run.
  - `--block`: Block the UI until the command finishes.
  - `--confirm`: When the template is provided, run it directly, no input UI was shown.

- hidden: Set the visibility of hidden files.

  - `show`: Show hidden files.
  - `hide`: Hide hidden files.
  - `toggle`: Default, toggle the hidden state.

- search

  - `rg`: Search files by content using ripgrep.
  - `fd`: Search files by name using fd.
  - `none`: Default, cancel the ongoing search.

- jump

  - `fzf`: Jump to a directory, or reveal a file using fzf.
  - `zoxide`: Jump to a directory using zoxide.

- sort

  - `by`
    - `"alphabetical"`: Sort alphabetically, e.g. `1.md` < `10.md` < `2.md`
    - `"created"`: Sort by creation time.
    - `"modified"`: Sort by last modified time.
    - `"natural"`: Sort naturally, e.g. `1.md` < `2.md` < `10.md`
    - `"size"`: Sort by file size.
  - `--reverse`: Display files in reverse order.
  - `--dir_first`: Display directories first.

### Tabs

- tab_create

  - `path`: Create a new tab using the specified path.
  - `--current`: Create a new tab using the current path.

- tab_close

  - `n`: Close the tab at position n, starting from 0.

- tab_switch

  - `n`: Switch to the tab at position n, starting from 0.
  - `--relative`: Switch to the tab at a position relative to the current tab. The value of n can be negative when using this parameter.

- tab_swap

  - `n`: Swap the current tab with the tab at position n, where negative values move the tab forward, and positive values move it backward.

### Tasks

- tasks_show: Show the task manager.

### Help

- help: Open the help menu.

## tasks

- close: Hide the task manager.
- arrow:
  - `-1`: Move the cursor up 1 line.
  - `1`: Move the cursor down 1 line.
- inspect: Inspect the task.
- cancel: Cancel the task.
- help: Open the help menu.

## select

- close: Cancel selection.
  - `--submit`: Submit the selection.
- arrow
  - `n`: Move the cursor up or down n lines. Negative value for up, positive value for down.
- help: Open the help menu.

## input

- close: Cancel input.

  - `--submit`: Submit the input.

- escape: Go back the normal mode, or cancel input.
- move: Move the cursor left or right.

  - `n`: Move the cursor n characters left or right. Negative value for left, positive value for right.
  - `--in-operating`: Move the cursor only if its currently waiting for an operation.

### Normal mode

- insert: Enter insert mode.

  - `--append`: Insert after the cursor.

- visual: Enter visual mode.
- backward: Move to the beginning of the previous word.
- forward: Move to the beginning of the next word.

  - `--end-of-word`: Move to the end of the next word.

- delete: Delete the selected characters.

  - `--cut`: Cut the selected characters into clipboard, instead of only deleting them.
  - `--insert`: Delete and enter insert mode.

- yank: Copy the selected characters.
- paste: Paste the copied characters after the cursor.

  - `--before`: Paste the copied characters before the cursor.

- undo: Undo the last operation.
- redo: Redo the last operation.

- help: Open the help menu.

### Insert mode

- close: Cancel input.

  - `--submit`: Submit the input.

- escape: Cancel insert mode and enter normal mode.

## Help

- close: Hide the help menu.
- escape: Clear the filter, or hide the help menu.
- arrow
  - `n`: Move the cursor up or down n lines. Negative value for up, positive value for down.
- filter: Apply a filter for the help items.