Configuration Reference

Manager Section ([manager])

[manager]
ratio       = [ 1, 3, 4 ]   # [parent, current, preview] width ratios
sort_by     = "natural"      # Sorting: "alphabetical", "natural", "mtime", "btime", "size", "random"
sort_dir_first = true        # Directories before files
linemode    = "none"         # Display: "none", "size", "mtime", "btime", "permissions", "owner", "symlink"
show_hidden = false          # Show dotfiles
scrolloff   = 5              # Scroll offset from edges

ratio

Defines the relative widths of the three panels (parent, current, preview). Example ratios:

Config	Parent	Current	Preview
[1, 3, 4]	12.5%	37.5%	50%
[1, 2, 3]	16.7%	33.3%	50%
[2, 3, 4]	22.2%	33.3%	44.5%

sort_by

Value	Sorts By
"alphabetical"	Lexicographic order (a < A < b)
"natural"	Human-friendly (a1, a2, a10)
"mtime"	Modification time (newest first)
"btime"	Birth/creation time
"size"	File size
"random"	Random order

linemode

Value	Shows
"none"	Filename only
"size"	File size
"mtime"	Modification time
"btime"	Birth time
"permissions"	Unix permissions
"owner"	File owner
"symlink"	Symlink target

Preview Section ([preview])

Key	Default	Description
images	true	Enable image preview
max_width	600	Max preview image width in px
max_height	900	Max preview image height in px
preload_workers	4	Background preload threads
max_file_size	"10M"	Max file size for text preview

Tasks Section ([tasks])

Key	Default	Description
micro_workers	4	Workers for small file operations
macro_workers	2	Workers for large file operations
bounded	true	Limit concurrent system operations

Opener Section ([opener])

[opener]
edit = [
  { run = "vim \"$@\"", block = true, desc = "Edit in vim" },
]

Field	Description
run	Shell command to execute
block	Block Yazi UI until command completes
desc	Human-readable description
orphan	Detach from Yazi process
for	Platform filter: "unix", "windows", "macos"