Configuration Overview
Yazi uses three main config files plus an optional fourth for virtual filesystems:
| File | Purpose |
|---|---|
yazi.toml | General behavior, preview, opening, tasks, plugins, input prompts |
keymap.toml | Key bindings across all modes/layers |
theme.toml | Colors, styles, icons |
vfs.toml | Remote filesystem (SFTP) connections |
Config Directories
| Platform | Path |
|---|---|
| Unix | ~/.config/yazi/ |
| Windows | %AppData%\yazi\config\ |
Override the config directory with the YAZI_CONFIG_HOME environment variable.
Configuration Mixing
Yazi supports partial overrides — you do not need to supply full config files. Only the keys you set are merged over the defaults.
For keymap and opener rules, use:
prepend_*— higher priority than the built-in defaultsappend_*— lower priority than the built-in defaults
info
The complete default configuration can be found on the shipped tag on GitHub.
tip
Use prepend_keymap instead of keymap to layer your bindings on top of the defaults without breaking future upstream additions.