yazi 25.4.8

[BrewTestBot]

Created by brew bump

---

Created with brew bump-formula-pr.

Details

release notes

## Breaking Changes

Supported wraparound navigation and enabled it by default. feat!: file navigation wraparound with new arrow prev and arrow next commands sxyazi/yazi#2485
Replaced tasks_show and close_input with tasks:show and input:close. refactor!: remove unnecessary tasks_show and close_input commands sxyazi/yazi#2530
frag, name, stem, ext, and parent on Url, name on tab::Tab, and is_hovered on fs::File are now properties. perf!: cache UserData fields sxyazi/yazi#2572
Swapped the default key bindings for z (zoxide) and Z (fzf). Enhance fzf integration sxyazi/yazi#2546
Used the new @sync peek annotation instead of the previewer's sync = true. feat!: new @sync peek annotation for sync previewers sxyazi/yazi#2487

Deprecated

ui.Padding and ui.Rect:padding() are deprecated. refactor: deprecate ui.Padding and ui.Rect:padding() sxyazi/yazi#2574

Packaging

SVG preview backend switched from ImageMagick to resvg and implemented as a new svg previewer. perf!: faster image preview with optimized magick arguments sxyazi/yazi#2533, feat!: switch to resvg as the SVG renderer sxyazi/yazi#2581

Custom Search Engine Lua API
With sxyazi/yazi#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:

  

    
    420258569-465b801b-3516-4f57-be09-8405da21e34d.mp4
    
  

  


Platform-Specific Key Binding
sxyazi/yazi#2526 adds a new optional for field to key bindings to specify the platform the key binding applies to.
For example:
{ 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. perf: rewrite config parser to double the startup speed sxyazi/yazi#2508
AVIF, HEIF, and JPEG XL previews have seen significant performance improvements. perf!: faster image preview with optimized magick arguments sxyazi/yazi#2533, thanks @ze0987
Compiled and cached the Lua bytecode to enhance the overall performance of the plugin system. perf: lazy compile and cache lua plugins as binary bytecode sxyazi/yazi#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.

  

    
    428400784-c120282b-a029-4cde-9092-699115318491.mp4
    
  

  


See sxyazi/yazi#2546 for more details.
Use Yazi File Manager Directly in Helix, Without Zellij or tmux
sxyazi/yazi#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!

  

    
    420651139-17a370d5-ee50-4cfa-8292-ed3159058ac6.mp4
    
  

  


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 sxyazi/yazi#2485.
New follow Command to Follow Files Pointed to by Symlinks
sxyazi/yazi#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 sxyazi/yazi#2578, you can now customize the input box opened by commands such as create, rename, cd, filter, find, search, and shell. For example:
{ 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 feat: new <C-A> and <C-E> keybindings to select entire line for the input component sxyazi/yazi#2439
fix: reserve a hack for Zellij to force an image adapter by @sxyazi in fix: reserve a hack for Zellij to force an image adapter sxyazi/yazi#2441
feat: new rt.term exports terminal emulator information by @sxyazi in feat: new rt.term exports terminal emulator information sxyazi/yazi#2442
fix: always show the size in the status bar even in empty directories by @sxyazi in fix: always show the size in the status bar even in empty directories sxyazi/yazi#2449
feat: allow tab_swap to cycle tabs by @sxyazi in feat: allow tab_swap to cycle tabs sxyazi/yazi#2456
feat: support using Yazi in Helix directly without Zellij or tmux by @sxyazi in feat: support using Yazi in Helix directly without Zellij or tmux sxyazi/yazi#2461
refactor: prefer WriteConsoleW for Windows console output by @sxyazi in refactor: prefer WriteConsoleW for Windows console output sxyazi/yazi#2464
ci: add label only if not removed manually by @sxyazi in ci: add label only if not removed manually sxyazi/yazi#2470
fix: force ANSI for keyboard progressive enhancement on Windows by @sxyazi in fix: force ANSI for keyboard progressive enhancement on Windows sxyazi/yazi#2474
feat: new fs.expand_url API by @sxyazi in feat: new fs.expand_url API sxyazi/yazi#2476
feat!: file navigation wraparound with new arrow prev and arrow next commands by @sxyazi in feat!: file navigation wraparound with new arrow prev and arrow next commands sxyazi/yazi#2485
feat!: new @sync peek annotation for sync previewers by @sxyazi in feat!: new @sync peek annotation for sync previewers sxyazi/yazi#2487
perf: lazy compile and cache lua plugins as binary bytecode by @sxyazi in perf: lazy compile and cache lua plugins as binary bytecode sxyazi/yazi#2490
feat: new base field for the Url userdata by @sxyazi in feat: new base field for the Url userdata sxyazi/yazi#2492
feat: allow repositioning the cursor in the rename DDS event by @sxyazi in feat: allow repositioning the cursor in the rename DDS event sxyazi/yazi#2521
feat: new symlink_target to style the target of symbolic links by @sxyazi in feat: new symlink_target to style the target of symbolic links sxyazi/yazi#2522
feat: platform-specific key binding by @sxyazi in feat: platform-specific key binding sxyazi/yazi#2526
feat: show error message when directory fails to load by @sxyazi in feat: show error message when directory fails to load sxyazi/yazi#2527
feat: allow bulk renaming to include trailing content in addition to the required new names by @MikuGeek in feat: allow bulk renaming to include trailing content in addition to the required new names sxyazi/yazi#2494
refactor!: remove unnecessary tasks_show and close_input commands by @sxyazi in refactor!: remove unnecessary tasks_show and close_input commands sxyazi/yazi#2530
perf!: faster image preview with optimized magick arguments by @ze0987 in perf!: faster image preview with optimized magick arguments sxyazi/yazi#2533
feat!: support arrow prev and arrow next for more components by @XOR-op in feat!: support arrow prev and arrow next for more components sxyazi/yazi#2540
feat: clear terminal before displaying EXIF data by @Integral-Tech in feat: clear terminal before displaying EXIF data sxyazi/yazi#2541
feat: new follow command to follow files pointed to by symlinks by @sxyazi in feat: new follow command to follow files pointed to by symlinks sxyazi/yazi#2543
fix: always check whether the cursor exceeds the upper bound to guard against unexpected values by @sxyazi in fix: always check whether the cursor exceeds the upper bound to guard against unexpected values sxyazi/yazi#2551
feat!: enhance fzf integration by @sxyazi in feat!: enhance fzf integration sxyazi/yazi#2553
feat: support Warp terminal image preview by @sxyazi in feat: support Warp terminal image preview sxyazi/yazi#2571
feat: allow initializing input when opening it with commands like rename, create, find, filter, etc. by @sxyazi in feat: allow initializing input when opening it with commands like rename, create, find, filter, etc. sxyazi/yazi#2578
fix: ignore XQuartz $DISPLAY variable by @sxyazi in fix: ignore XQuartz $DISPLAY variable sxyazi/yazi#2586
fix: don't fail on videos with embedded images by @ze0987 in fix: don't fail on videos with embedded images sxyazi/yazi#2590

New Contributors

@MikuGeek made their first contribution in feat: allow bulk renaming to include trailing content in addition to the required new names sxyazi/yazi#2494
@ze0987 made their first contribution in perf!: faster image preview with optimized magick arguments sxyazi/yazi#2533

Full Changelog: sxyazi/yazi@v25.3.2...v25.4.8

[github-actions]

🤖 An automated task has requested bottles to be published to this PR.

Please do not push to this PR branch before the bottle commits have been pushed, as this results in a state that is difficult to recover from. If you need to resolve a merge conflict, please use a merge commit. Do not force-push to this PR branch.