v26.9.12026-09-01
See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v2691 for the changelog.
v26.8.152026-08-15
See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v26815 for the changelog.
v26.5.62026-05-05
See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v2656 for the changelog.
v26.1.222026-01-22
See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v26122 for the changelog.
v26.1.42026-01-04
See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v2614 for the changelog.
v25.12.292025-12-29
See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v251229 for the changelog.
v25.5.312025-05-30
This is a maintenance release, focusing on bug fixes.
What's Changed
* fix: expose ui.Wrap by @sxyazi in https://github.com/sxyazi/yazi/pull/2810
* fix: forward --end-of-word of the input should consider the mode's delta by @sxyazi in https://github.com/sxyazi/yazi/pull/2811
* fix: make every effort to carry hidden states for dummy files by @sxyazi in https://github.com/sxyazi/yazi/pull/2814
Full Changelog: https://github.com/sxyazi/yazi/compare/v25.5.28...v25.5.31
v25.5.282025-05-28
Breaking Changes
- [manager] is deprecated in favor of the new [mgr]. https://github.com/sxyazi/yazi/pull/2803
- tab_width has been removed as it no longer needs to be set manually. https://github.com/sxyazi/yazi/pull/2745
- tabactive and tabinactive are moved under the new [tabs] section. https://github.com/sxyazi/yazi/pull/2745
- sixel_fraction has been removed as it's no longer needed. https://github.com/sxyazi/yazi/pull/2707
Deprecated
- ya.mgremit(), ya.appemit() and ya.input_emit() are deprecated. https://github.com/sxyazi/yazi/pull/2653
- ya.preview_widgets() is deprecated. https://github.com/sxyazi/yazi/pull/2706
- Command:args() is deprecated. https://github.com/sxyazi/yazi/pull/2752
- The ya pack subcommand is deprecated. https://github.com/sxyazi/yazi/pull/2770
- LEFT, CENTER, RIGHT on ui.Line, ui.Text are deprecated. https://github.com/sxyazi/yazi/pull/2802
- NONE, TOP, RIGHT, BOTTOM, LEFT, ALL on ui.Bar, ui.Border are deprecated. https://github.com/sxyazi/yazi/pull/2802
- WRAPNO, WRAP, WRAPTRIM on ui.Text are deprecated. https://github.com/sxyazi/yazi/pull/2802
Redesign Tabs
https://github.com/sxyazi/yazi/pull/2745 decouples tabs from the header into an independent tab bar component to enhance UX:
- A standalone single-line component increases the available space for displaying tabs.
- Tab titles are displayed by default to increase recognizability.
- Supports switching tabs via mouse for easier navigation.
The new tab bar is only shown when there is more than one tab, ensuring no space is wasted for users who don't use tabs.
https://github.com/user-attachments/assets/5ca33561-7558-4b9c-8b6a-9dfbc0bc8aa4
Calculate Real-Time Directory Size in Spotter
https://github.com/sxyazi/yazi/pull/2695 adds directory sizes to the folder spotter. The size is computed dynamically in real time and asynchronously, which means:
- Every time a user clicks <Tab> on a directory, the latest size is calculated.
- For large directories, real-time changes in size are reported to the user, with "(?)" appended at the end to indicate that the calculation is in progress.
- If the user closes the spotter or switches directories using the left/right arrow keys, any ongoing calculations will be canceled to avoid wasting resources.
Also, the computed directory size will be updated in the file list:
- If the user sets linemode = size, the latest size will be shown on the right of the file line.
- If the user sets sort_by = size, the file list will be sorted by the latest sizes (if necessary).
https://github.com/user-attachments/assets/eb2981e6-3e02-4997-abfc-83cc456a1677
9x Faster Sixel Image Preview
https://github.com/sxyazi/yazi/pull/2707 replaces the existing neural network quantization algorithm with Wu's Color Quantizer, which offers better performance while maintaining comparable quality.
Old implementation (neural network via colorquant, with default sixelfraction = 20) – average 189.5763999ms:
``sh
time: 190.025ms
time: 191.054417ms
time: 187.696792ms
time: 188.060791ms
time: 189.381958ms
time: 191.618042ms
time: 192.383125ms
time: 190.511291ms
time: 187.8395ms
time: 187.193083ms
`
New implementation (Wu - sRGB via quantette) – average 20.9199916ms:
`sh
time: 21.226458ms
time: 20.719542ms
time: 21.207583ms
time: 20.815875ms
time: 21.071291ms
time: 21.273459ms
time: 20.811792ms
time: 20.723166ms
time: 20.52675ms
time: 20.824ms
`
piper.yazi Plugin
With piper.yazi, you can use the output of any shell command as preview content. This eliminates the need to write a separate plugin for each command, making the use of custom previewers much more convenient.
screenshot-002418
See https://github.com/yazi-rs/plugins/tree/main/piper.yazi#examples for more examples!
Double Directory Size Calculation Speed
https://github.com/sxyazi/yazi/pull/2683 greatly improves directory computation performance by dividing the task into chunks and reusing existing threads. Directory sorting and file trashing will be observably twice as fast.
Run the benchmark script against a 10.16GB folder 5 times in release mode:
`sh
Old: elapsed 759.877791ms
New: elapsed 364.802583ms
Old: elapsed 734.5155ms
New: elapsed 360.103375ms
Old: elapsed 734.124167ms
New: elapsed 365.662458ms
Old: elapsed 733.27325ms
New: elapsed 365.694042ms
Old: elapsed 743.394875ms
New: elapsed 364.455083ms
`
Input Component Now Supports Password Mode
With https://github.com/sxyazi/yazi/pull/2675, a new obscure = true option is available:
`lua
local value = ya.input {
title = "Password:",
obscure = true,
position = { "center", w = 50 },
}
`
https://github.com/user-attachments/assets/ff5b21f2-977b-4e9f-a279-e4cb15b51a57
Truncate Long Items in the File List
https://github.com/sxyazi/yazi/pull/2754, https://github.com/sxyazi/yazi/pull/2759, and https://github.com/sxyazi/yazi/pull/2778 add truncation support for long filenames in the file list and archive preview, and display file extensions at the end, ensuring that even if a filename is truncated, you can still know what file type it is by its extension.
https://github.com/user-attachments/assets/0f1afbdb-17ec-410f-adea-e8b1d2ed6341
types.yazi Plugin
For a long time, Yazi lacked a type definition file, which made plugin development very painful. Now, it's here!
types.yazi provides type definitions for Yazi's Lua API, empowering an efficient plugin development experience.
Improved Built-In Previewers
- The video previewer now supports displaying embedded video covers, https://github.com/sxyazi/yazi/pull/2640
- The magick previewer will respect the user's imagealloc and imagebound settings, to limit its maximum resource usage, https://github.com/sxyazi/yazi/pull/2602, thanks to @ze0987
- The video previewer will respect the user's max_width setting, https://github.com/sxyazi/yazi/pull/2560, thanks to @ze0987
Improve Path Auto-Completion Results
The auto-completion results for interactive cd (key: g => <Space>) will now more closely match the user's input keywords.
Done in https://github.com/sxyazi/yazi/pull/2765
What's Changed
* fix: reverse the mixing order of theme and flavor configuration by @sxyazi in https://github.com/sxyazi/yazi/pull/2594
* feat: limit memory usage for previewing large images by @ze0987 in https://github.com/sxyazi/yazi/pull/2602
fix: respect the user's maxwidth setting for the built-in video previewer by @ze0987 in https://github.com/sxyazi/yazi/pull/2560
* feat: allow custom exit code with quit --code by @Nicholas42 in https://github.com/sxyazi/yazi/pull/2609
* fix: ensure state synchronization even when the package update fails midway by @sxyazi in https://github.com/sxyazi/yazi/pull/2613
* fix: do not change revision when package deployment fails by @sxyazi in https://github.com/sxyazi/yazi/pull/2627
* feat: copy-on-write support for field caching by @sxyazi in https://github.com/sxyazi/yazi/pull/2629
* feat: fall back to CSI 16 t` when PowerShell OpenSSH returns a fake terminal size by @sxyazi in https://github.com/sxyazi/yazi/pull/2636
* feat: support embedded cover for video preview by @sxy
v25.4.82025-04-08
Breaking Changes
- Supported wraparound navigation and enabled it by default. https://github.com/sxyazi/yazi/pull/2485
- Replaced tasksshow and closeinput with tasks:show and input:close. https://github.com/sxyazi/yazi/pull/2530
- frag, name, stem, ext, and parent on Url, name on tab::Tab, and is_hovered on fs::File are now properties. https://github.com/sxyazi/yazi/pull/2572
- Swapped the default key bindings for z (zoxide) and Z (fzf). https://github.com/sxyazi/yazi/issues/2546
- Used the new @sync peek annotation instead of the previewer's sync = true. https://github.com/sxyazi/yazi/pull/2487
Deprecated
- ui.Padding and ui.Rect:padding() are deprecated. https://github.com/sxyazi/yazi/pull/2574
Packaging
- SVG preview backend switched from ImageMagick to resvg and implemented as a new svg previewer. https://github.com/sxyazi/yazi/pull/2533, https://github.com/sxyazi/yazi/pull/2581
Custom Search Engine Lua API
With https://github.com/sxyazi/yazi/pull/2452, you can create custom search engines via the Lua API, meaning that plugins can serve as the source for search view file lists.
A new plugin vcs-files.yazi is available to display the list of files changed in Git within Yazi:
https://github.com/user-attachments/assets/ca6f7d55-002b-4933-b8e8-41f335b96a2b
Platform-Specific Key Binding
https://github.com/sxyazi/yazi/pull/2526 adds a new optional for field to key bindings to specify the platform the key binding applies to.
For example:
``sh
{ on = [ 'g', 'd' ], run = 'cd ~/dev', desc = 'Go dev', for = 'unix' },
{ on = [ 'g', 'd' ], run = 'cd C:\dev', desc = 'Go C:\dev', for = 'windows' },
`
Performance Improvements
This version brings several performance enhancements:
- Configuration parser has been rewritten to double the startup speed. https://github.com/sxyazi/yazi/pull/2508
- AVIF, HEIF, and JPEG XL previews have seen significant performance improvements. https://github.com/sxyazi/yazi/pull/2533, thanks @ze0987
- Compiled and cached the Lua bytecode to enhance the overall performance of the plugin system. https://github.com/sxyazi/yazi/pull/2490
Enhance fzf Integration
Now, you can select multiple files in fzf, and the selected files will also be selected in Yazi.
Also, you can now view, navigate, and deselect the file selection list from Yazi within fzf.
https://github.com/user-attachments/assets/f7b175a3-fa73-4128-8239-f90e45f13ab3
See https://github.com/sxyazi/yazi/issues/2546 for more details.
Use Yazi File Manager Directly in Helix, Without Zellij or tmux
https://github.com/sxyazi/yazi/pull/2461 adapted Yazi to support Helix's :insert-output, which means you can now run Yazi directly within Helix – it even supports image and video previews!
https://github.com/user-attachments/assets/9dbf7aca-fc4e-4f9e-b554-70cadedf0484
New prev and next Arguments to arrow for Wraparound Navigation
Circular navigation is one of the long-requested features, and is now supported via the new arrow prev and arrow next commands in https://github.com/sxyazi/yazi/pull/2485.
New follow Command to Follow Files Pointed to by Symlinks
https://github.com/sxyazi/yazi/pull/2543 adds support for following files pointed to by symlinks.
A new key binding, g => f (follow hovered symlink), has been added to use this feature.
Allow Initializing Input When Opening It with Commands Like rename, create, find, filter, etc.
With https://github.com/sxyazi/yazi/pull/2578, you can now customize the input box opened by commands such as create, rename, cd, filter, find, search, and shell. For example:
`sh
{ on = "r", run = [ "rename", "input:escape" ] }
`
This will open the rename input box and exit insert mode, meaning that the default state will be normal mode.
What's Changed
* feat: new <C-A> and <C-E> keybindings to select entire line for the input component by @sxyazi in https://github.com/sxyazi/yazi/pull/2439
* fix: reserve a hack for Zellij to force an image adapter by @sxyazi in https://github.com/sxyazi/yazi/pull/2441
* feat: new rt.term exports terminal emulator information by @sxyazi in https://github.com/sxyazi/yazi/pull/2442
* fix: always show the size in the status bar even in empty directories by @sxyazi in https://github.com/sxyazi/yazi/pull/2449
feat: allow tabswap to cycle tabs by @sxyazi in https://github.com/sxyazi/yazi/pull/2456
* feat: support using Yazi in Helix directly without Zellij or tmux by @sxyazi in https://github.com/sxyazi/yazi/pull/2461
* refactor: prefer WriteConsoleW for Windows console output by @sxyazi in https://github.com/sxyazi/yazi/pull/2464
* ci: add label only if not removed manually by @sxyazi in https://github.com/sxyazi/yazi/pull/2470
* fix: force ANSI for keyboard progressive enhancement on Windows by @sxyazi in https://github.com/sxyazi/yazi/pull/2474
feat: new fs.expandurl API by @sxyazi in https://github.com/sxyazi/yazi/pull/2476
* feat!: file navigation wraparound with new arrow prev and arrow next commands by @sxyazi in https://github.com/sxyazi/yazi/pull/2485
* feat!: new @sync peek annotation for sync previewers by @sxyazi in https://github.com/sxyazi/yazi/pull/2487
* perf: lazy compile and cache lua plugins as binary bytecode by @sxyazi in https://github.com/sxyazi/yazi/pull/2490
* feat: new base field for the Url userdata by @sxyazi in https://github.com/sxyazi/yazi/pull/2492
* feat: allow repositioning the cursor in the rename DDS event by @sxyazi in https://github.com/sxyazi/yazi/pull/2521
feat: new symlinktarget to style the target of symbolic links by @sxyazi in https://github.com/sxyazi/yazi/pull/2522
* feat: platform-specific key binding by @sxyazi in https://github.com/sxyazi/yazi/pull/2526
* feat: show error message when directory fails to load by @sxyazi in https://github.com/sxyazi/yazi/pull/2527
* feat: allow bulk renaming to include trailing content in addition to the required new names by @MikuGeek in https://github.com/sxyazi/yazi/pull/2494
refactor!: remove unnecessary tasksshow and close_input commands by @sxyazi in https://github.com/sxyazi/yazi/pull/2530
* perf!: faster image preview with optimized magick arguments by @ze0987 in https://github.com/sxyazi/yazi/pull/2533
* feat!: support arrow prev and arrow next for more components by @XOR-op in https://github.com/sxyazi/yazi/pull/2540
* feat: clear terminal before displaying EXIF data by @Integral-Tech in https://github.com/sxyazi/yazi/pull/2541
* feat: new follow command to follow files pointed to by symlinks by @sxyazi in https://github.com/sxyazi/yazi/pull/2543
* fix: always check whether the cursor exceeds the upper bound to guard against unexpected values by @sxyazi in https://github.com/sxyazi/yazi/pull/2551
* feat!: enhance fzf integration by @sxyazi in https://github.com/sxyazi/yazi/pull/2553
* feat: support Warp terminal image preview by @sxyazi in https://github.com/sxyazi/yazi/pull/2571
* feat: allow initializing input when opening it with commands like rename, create, find, filter, etc. by @sxyazi in https://github.com/sxyazi/yazi/pull/2578
* fix: ignore XQuartz $DISPLAY` variable by @sxyazi in https://github.com/sxyazi/yazi/pull/2586
* fix: don't fail on videos with embedded images by @ze0987 in https://github.com/sxyazi/yazi/pull/2590
New Contributors
* @MikuGeek made their first contribution in https://github.com/sxyazi/yazi/pull/2494
* @ze0987 made their first contribution in https://github.com/sxyazi/yazi/pull/25
v25.3.22025-03-02
This is a quick fix release that addresses the issue where, under SSH, terminal response sequences are not completely consumed and are leaked to the screen.
Thanks to @Crdr0122 and @SpookyYomo for reporting and helping reproduce the issue!
What's Changed
* feat: expose all theme fields in Lua by @hankertrix in https://github.com/sxyazi/yazi/pull/2405
fix: windows-sys features for Win32StorageFileSystem and Win32System_Threading by @sxyazi in https://github.com/sxyazi/yazi/pull/2417
* fix: ignore stdin redirection to ensure always accessing the real tty by @sxyazi in https://github.com/sxyazi/yazi/pull/2425
fix: STDINFILENO poll always returns 0 under SSH by @sxyazi in https://github.com/sxyazi/yazi/pull/2427
* feat: expose almost the entirety of the user's configuration in Lua by @hankertrix in https://github.com/sxyazi/yazi/pull/2413
* chore: bump version to 25.3.2 by @sxyazi in https://github.com/sxyazi/yazi/pull/2428
Full Changelog: https://github.com/sxyazi/yazi/compare/v25.2.26...v25.3.2