Yazi: baixar versions anteriors

See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v2691 for the changelog.

See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v26815 for the changelog.

See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v2656 for the changelog.

See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v26122 for the changelog.

See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v2614 for the changelog.

See https://github.com/sxyazi/yazi/blob/main/CHANGELOG.md#v251229 for the changelog.

This is a maintenance release, focusing on bug fixes.
What's Changed
- fix: expose ui.Wrap by @sxyazi in #2810
- fix: forward --end-of-word of the input should consider the mode's delta by @sxyazi in #2811
- fix: make every effort to carry hidden states for dummy files by @sxyazi in #2814
Full Changelog: v25.5.28...v25.5.31

Breaking Changes
- [manager] is deprecated. #2803
- tab_width is removed since no longer need to set it manually. #2745
- tab_active and tab_inactive are moved under the new [tabs] section. #2745
Deprecated
- ya.mgr_emit(), ya.app_emit() and ya.input_emit() are deprecated. #2653
- ya.preview_widgets() is deprecated. #2706
- Command:args() is deprecated. #2752
- The ya pack subcommand is deprecated. #2770
- LEFT, CENTER, RIGHT on ui.Line, ui.Text are deprecated. #2802
- NONE, TOP, RIGHT, BOTTOM, LEFT, ALL on ui.Bar, ui.Border are deprecated. #2802
- WRAP_NO, WRAP, WRAP_TRIM on ui.Text are deprecated. #2802
Redesign Tabs
#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.
442474569-5ac79095-9a4a-444e-894a-e6ee0e992815.mp4
Calculate Real-Time Directory Size in Spotter
#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).
438794791-568ca1b2-5858-4f38-a053-a099dffa3b1c.mp4
9x Faster Sixel Image Preview
#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 color_quant, with default sixel_fraction = 20) – average 189.5763999ms:
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:
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
Double Directory Size Calculation Speed
#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:
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 #2675, a new obscure = true option is available:
local value = ya.input {
title = "Password:",
obscure = true,
position = { "center", w = 50 },
}
screenshot-002319.mp4
Truncate Long Items in the File List
#2754, #2759, and #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.
screenshot-002518.mp4
Improved Built-In Previewers
- The video previewer now supports displaying embedded video covers, #2640
- The magick previewer will respect the user's image_alloc and image_bound settings, 

Breaking Changes
- Supported wraparound navigation and enabled it by default. #2485
- Replaced tasks_show and close_input with tasks:show and input:close. #2530
- frag, name, stem, ext, and parent on Url, name on tab::Tab, and is_hovered on fs::File are now properties. #2572
- Swapped the default key bindings for z (zoxide) and Z (fzf). #2546
- Used the new @sync peek annotation instead of the previewer's sync = true. #2487
Deprecated
- ui.Padding and ui.Rect:padding() are deprecated. #2574
Packaging
- SVG preview backend switched from ImageMagick to resvg and implemented as a new svg previewer. #2533, #2581
Custom Search Engine Lua API
With #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
#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. #2508
- AVIF, HEIF, and JPEG XL previews have seen significant performance improvements. #2533, thanks @ze0987
- Compiled and cached the Lua bytecode to enhance the overall performance of the plugin system. #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 #2546 for more details.
Use Yazi File Manager Directly in Helix, Without Zellij or tmux
#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 #2485.
New follow Command to Follow Files Pointed to by Symlinks
#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 #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 #2439
- fix: reserve a hack for Zellij to force an image adapter by @sxyazi in #2441
- feat: new rt.term exports terminal emulator information by @sxyazi in #2442
- fix: always show the size in the status bar even in empty directories by @sxyazi in #2449
- feat: allow tab_swap to cycle tabs by @sxyazi in #2456
- feat: support using Yazi in Helix directly without Zellij or tmux by @sxyazi in #2461
- refactor: prefer WriteConsoleW for Windows console output by @sxyazi in #2464
- ci: add label only if not removed manually by @sxyazi in #2470
- fix: force ANSI for keyboard progressive enhancement on Windows by @sxyazi in #2474
- feat: new fs.expand_url API by @sxyazi in #2476
- feat!: file navigation wraparound with new arrow prev and arrow next commands by @sxyazi in #2485
- feat!: new @sync peek annotation for sync previewers by @sxyazi in #2487
- perf: lazy compile and cache lua plugins as binary bytecode by @sxy

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 #2405
- fix: windows-sys features for Win32_Storage_FileSystem and Win32_System_Threading by @sxyazi in #2417
- fix: ignore stdin redirection to ensure always accessing the real tty by @sxyazi in #2425
- fix: STDIN_FILENO poll always returns 0 under SSH by @sxyazi in #2427
- feat: expose almost the entirety of the user's configuration in Lua by @hankertrix in #2413
- chore: bump version to 25.3.2 by @sxyazi in #2428
Full Changelog: v25.2.26...v25.3.2

Breaking Changes
- The [completion] component has been renamed to [cmp]. #2399
Deprecated
- MANAGER, PREVIEW, PLUGIN, and THEME have been deprecated in favor of the new rt and th. #2389
- ya.manager_emit() has been deprecated in favor of the new ya.mgr_emit(). #2397
Built-in Previewer Improvements
- The JSON previewer will now respect the user's wrap setting to support automatic JSON line wrapping. #2337, thanks @boydaihungst
- The PDF previewer will now respect the user's max_width setting to address the issue of previewing content that is too small. #2331
- The ImageMagick previewer will now respect the user's image_alloc setting to limit memory usage. #2403
New Search Engine: rga
#2383 (thanks @paperbenni) has added a new ripgrep-all search engine.
It is a wrapper around ripgrep that supports additional file formats (such as PDF, docx, epub, etc.).
You can use it with the search --via=rga command.
Allow to Specify Layer for Keymap Commands
With #2399, you'll now be able to assign commands from different layers to a keybinding in keymap.toml.
This opens up the possibility of interacting with any other component, such as accessing commands from the manager ([manager]) within the input component ([input]):
[[input.prepend_keymap]]
on = "<Esc>"
run = [ "close", "mgr:escape --filter" ]
desc = "Close input and cancel the filter"
When you press Esc in the input box to exit the filter view (triggered by the f key), the filter will be canceled as the input is closed.
More Flexible Status Bar Customization
#2313 (thanks @PFiS1737) introduces sep_left and sep_right to replace the previous separator_open and separator_close settings, allowing different separators to be set for the left and right sides:
status-sep-explain
Support for Setting Spotter Table Styles
#2391 introduces two new settings, tbl_col and tbl_cell, in theme.toml to configure the styles for table columns and cells respectively.
screenshot-002264
What's Changed
- feat!: allow different separators to be applied individually to the left and right sides of the status bar by @PFiS1737 in #2313
- fix: load mount points with the best effort even if the /dev/disk/by-label directory does not exist by @sxyazi in #2326
- feat: CSI-based Vim and Neovim built-in terminal detection for better accuracy by @sxyazi in #2327
- feat: respect the user's max_width setting for the built-in PDF preloader by @sxyazi in #2331
- feat: respect the user's wrap setting for the built-in JSON previewer by @boydaihungst in #2337
- refactor: consistent naming for enum variants by @sxyazi in #2339
- feat: new external and removable fields in the fs.partitions() API by @sxyazi in #2343
- feat: terminal response detection under async stdin by @sxyazi in #2347
- fix: incorrect kebab-case for the notify level enum by @hankertrix in #2349
- fix: add maximum preview limit under /proc virtual file system by @sxyazi in #2355
- feat: add a link to the debugging instructions in yazi --debug by @sxyazi in #2365
- fix: didn't reset previous Cha when loading directories in chunks by @sxyazi in #2366
- feat: make incompatible version message more clear by @sxyazi in #2377
- feat: bump trash and libc versions to support NetBSD by @sxyazi in #2388
- feat: new rt and th allow to access user configuration and theme scheme in sync/async plugins consistently by @sxyazi in #2389
- feat: new tbl_col and tbl_cell in theme system for spotter table styling by @sxyazi in #2391
- feat: add ripgrep-all support for search by @paperbenni in #2383
- feat: new cf.args to access startup arguments by @sxyazi in #2392
- refactor: rename cf to rt by @sxyazi in #2393
- feat: expose mode field in Cha by @sxyazi in #2394
- refactor: rename rt.manager to rt.mgr, and th.manager to th.mgr by @sxyazi in #2397
- feat!: allow to specify layer for keymap commands by @sxyazi in #2399
New Contributors
- @PFiS1737 made their first contribution in #2313
- @paperbenni made their first contribution in #2383
Full Changelog: v25.2.11...v25.2.26

This is a quick fix release that addresses a few issues introduced in the previous version 25.2.7.
Besides that, a new overall option has been added under [status] in theme.toml, which allows you to set the overall style of the status bar, specifically the empty area in the center:
[status]
overall = { fg = "#cad3f5", bg = "#181926" }
411906568-4ab46d09-9f2c-489b-85f3-83f264ecd9cc
See #2321 for details.
What's Changed
- fix: reverse the order of CSI-based and environment-based terminal detection by @sxyazi in #2310
- feat: reduce terminal response wait timeout by @sxyazi in #2314
- fix: unable to delete sealed files on Windows due to platform differences by @sxyazi in #2319
- feat: new overall option under [status] to allow specifying the overall style of the status bar by @sxyazi in #2321
- chore: bump version to 25.2.11 by @sxyazi in #2323
Full Changelog: v25.2.7...v25.2.11

Deprecated
- ya.md5() has been deprecated in favor of the new ya.hash(), in #2168
- The plugin entry file init.lua has been deprecated in favor of the new main.lua, in #2168
- arrow -99999999 and arrow 99999999 have been deprecated in favor of the new arrow top and arrow bot, in #2294
- The --args option in the plugin command has been deprecated in favor of a new 2nd positional parameter, in #2299
- The numeric return value of the preloader has been deprecated in favor of a new boolean return value, in #2253
The mount.yazi Plugin
For a long time, I've been receiving requests from users for a mount manager, but never had the time to finish it. But now — it's here!
mount.yazi provides disk mount, unmount, and eject functionality:
404254109-c6f780ab-458b-420f-85cf-2fc45fcfe3a2.mp4
Done in #2199.
Simplification of shell and plugin commands
With #2298, you can now write shell scripts directly after -- (end of options marker). Everything after -- will be treated as raw text, so no more escaping is required, greatly simplifying the writing of complex commands.
For example, previously, a simple echo "hello 'world'" would look like this:
[[manager.prepend_keymap]]
on = "<C-e>"
run = '''
shell --block 'echo "hello '\''world'\''"'
'''
This resulted in nested quotes, which was error-prone and unintuitive.
Now, you can directly include the entire shell script as plain text after -- without any escaping:
[[manager.prepend_keymap]]
on = "<C-e>"
run = '''
shell --block -- echo "hello 'world'"
'''
Similarly, with #2299, the plugin command usage has been simplified as well. For instance:
[[manager.prepend_keymap]]
on = "<C-e>"
run = "plugin search --args='\'hello world\''"
Can now be written as:
[[manager.prepend_keymap]]
on = "<C-e>"
run = "plugin search -- 'hello world'"
Replace Mode and Vim Motions (W, E, B, ^, _) for Inputs
The Input component now supports replace mode and several new Vim motions, including:
- W: Move forward to the start of the next WORD
- E: Move forward to the end of the current or next WORD
- B: Move back to the start of the current or previous WORD
- ^: Move to the first non-whitespace character
- _: Move to the first non-whitespace character
Thanks to @dxrcy for the work in #2143!
Package Manager Enhancements
The package manager now supports the following new features:
- ya pack -d to delete a package (thanks @MrAsler, #2181)
- Support for adding and removing multiple packages with a single command (thanks @evpeople, #2257)
Support Local tmux Image Preview Over SSH
Now, when you start tmux locally, connect to a remote SSH session, and run Yazi on the remote host, you'll get image preview support out of the box.
Done in #2229.
New @since Plugin Annotation to Specify the Minimum Supported Yazi Version
You can now optionally specify the minimum supported Yazi version in your plugin:
--- @since 25.2.7
return {
entry = function() end
}
If specified, and the user's Yazi version is lower than the given version, they will receive an error message preventing the plugin from running accidentally.
Done in #2290
New ya.confirm() API
The new ya.confirm() API allows you to show a confirmation prompt to the user:
local answer = ya.confirm {
pos = { "center", w = 40, h = 10 },
title = "Test",
content = "Hello, World!",
}
You can also apply a UI element to the title and content to customize the appearance:
local answer = ya.confirm {
pos = { "center", w = 40, h = 10 },
title = ui.Line("Test"):fg("yellow"):bold(),
content = ui.Text("Hello, World!"):bg("red"):fg("#ffffff"),
}

This is a quick patch release with 3 fixes:
- Fixed an issue where switching directories in Yazi didn't update the CWD, causing issues with features that depend on the CWD (like terminal splitting and cd --interactive path completion).
- Fixed a bug where the UI wouldn't refresh when returning to Yazi from an external blocking process (like a shell) while in an empty directory.
- Fixed an issue where the preview wouldn't update after sorting directories when using the Folder-specific rules tip.
Here are some new features:
- Added support for a large number of new archive formats for extraction, previewing, and filetype highlighting in #1926 (thanks to @Integral-Tech).
- Added a new temporary option _v4_suppress_deprecation_warnings in #2027 to suppress all deprecation warnings as a workaround for the transition to version 0.4:
# yazi.toml
[manager]
_v4_suppress_deprecation_warnings = true

- Added 2 new Lua APIs
- fs.cwd() - get the current working directory
- fs.create() - create a directory
What's Changed
- fix: interactive cd autocomplete doesn't follow the latest CWD changes by @sxyazi in #2025
- feat: new option to suppress 0.4 deprecation warnings by @sxyazi in #2027
- fix: offset cursor shift when deleting multiple files in bulk by @sxyazi in #2030
- chore: bump version to 0.4.2 by @sxyazi in #2031
- fix: choose a more conservative macro_workers value to ensure concurrency safety with certain USB flash drives by @sxyazi in #2040
- feat: support for Android platform in the for qualifier of opener by @sxyazi in #2041
- fix: set the current working directory in a thread-safe way by @sxyazi in #2043
- fix: allow-passthrough must be set to on to prevent tmux from forwarding the real terminal's response to the inactive pane by @sxyazi in #2052
- fix: pass through show_hidden when building default Files by @sxyazi in #2057
- fix: use a less intrusive DSR instead of DA1 workaround to forward terminal responses twice in tmux by @sxyazi in #2058
- feat: new --cwd parameter for the shell command and fs.cwd() API by @sxyazi in #2060
- feat: allow noop for single-key chords by removing the mixing length limit by @sxyazi in #2064
- ci: add riscv64gc-unknown-linux-gnu target by @Integral-Tech in #2067
- fix: missing a render after resuming from an external blocking process by @sxyazi in #2071
- feat: add more supported archive formats to the preset config by @Integral-Tech in #1926
- feat: new fs.create() Lua API by @hankertrix in #2068
- fix: missing a hover after reordering from an external plugin by @sxyazi in #2072
Full Changelog: https://github.com/sxyazi/yazi/compare/v0.4.1...v0.4.2

This is a quick patch version with 4 fixes:
- Fixed an issue where Yazi would freeze when waiting for terminal response, in old tmux versions (v3.2a or lower), or 2-layer nested terminal setup (tmux -> Neovim's :terminal -> Yazi).
- Fixed a bug in the Überzug++ backend where certain image dimension parsing failed, preventing images from displaying.
- Fixed a build failure for Android 32-bit architectures.
- Fixed an issue with the preset archive and json plugins not handling CRLF properly on Windows.
What's Changed
- fix: disable passthrough when the user launches Yazi in Neovim inside tmux by @sxyazi in #2014
- refactor: replace format! with concat! for string literals by @Integral-Tech in #2012
- fix: correctly handle CRLF on Windows in preset archive and json plugins by @sxyazi in #2017
- fix: failed to parse certain image dimensions for Überzug++ backend by @sxyazi in #2020
- chore: bump version to 0.4.1 by @sxyazi in #2022
Full Changelog: https://github.com/sxyazi/yazi/compare/v0.4.0...v0.4.1

This version fixes a regression from the previous release that caused some keys to stop working. And it resolves a long-standing issue where the file list couldn't refresh automatically in Windows WSL.This version also introduces the following three new features:Git integration
Show the status of Git file changes as a linemode in the file list.Feel free to use it and report any issues! For now, you need to manually install it (pretty easy to do) from In the future, it will be included as one of Yazi's built-in plugins.size linemode supports displaying the number of files in a directory
#1591 updates the size linemode for directories to support displaying the number of files within the directory instead of leaving it blank as before.If size information is available for the directory (triggered when sorting by size), that information will be shown as a priority.Windows Terminal support for image previews
Windows Terminal Preview v1.22.2362.0 now supports the Sixel image format. Yazi provided an adaptation for this in #1588 (Thanks @e82eric).Note that Windows Terminal Preview v1.22.2362.0 has a bug that can cause Yazi to time out at startup. If you want to try this feature, make sure to apply the patch from What's Changed
- fix: keybindings disappear when mixing presets with a wrong filter condition by @sxyazi in #1568
- fix: check compositor support status before using ueberzug wayland output by @taoky in #1566
- fix: fallback to PollWatcher on WSL by @sxyazi in #1574
- fix: continuous fetcher was not scheduled consecutively by @sxyazi in #1575
- fix: Rail component should have a higher rendering priority by @sxyazi in #1585
- perf: truncate long lists in confirm dialogs by @sxyazi in #1590
- feat: size linemode supports showing the file count for directories by @sxyazi in #1591
- feat: support image preview in Windows Terminal by @e82eric in #1588
- chore: upgrade ratatui to 0.28.1 by @sxyazi in #1601
- feat: add is_absolute, has_root, starts_with, ends_with, strip_prefix to Url Userdata by @sxyazi in #1605
- feat: add dict_merge() function by @sxyazi in #1609
New Contributors
- @taoky made their first contribution in #1566
- @e82eric made their first contribution in #1588
Full Changelog: https://github.com/sxyazi/yazi/compare/v0.3.2...v0.3.3

This version introduces two eagerly awaited new features: a brand-new confirm component, and word wrapping.Brand-new confirm component
#1167 (thanks to @thelamb) introduces a brand-new confirm component that handles various confirmations (like trashing files, deleting files, overwriting files, and exit confirmations). The goal is to provide a safer and more efficient user experience:
- Safer: Now, when you trash, delete, or overwrite files, it'll show a list of affected files for a second confirmation, instead of just the number of files like before.
- More efficient: Confirmation now only requires pressing Enter once, instead of typing "y" and then pressing Enter. This should be a nice quality-of-life improvement.
Word wrapping
#1159 (thanks to @mskvsk and @ArtyomArtamonov) adds a new wrap option under [preview], which can be set to "no" or "yes". When set to "yes", word wrapping is enabled:
# ~/.config/yazi/yazi.toml
[preview]
wrap = "yes"

Image preview performance optimization
I've been working on optimizing Yazi's image preview speed, and with multi-threading, preloading, and a built-in image decoder, it should already be the fastest among all terminal file managers.However, I noticed some lag during fast scrolling and realized that at this point, the performance bottleneck isn't Yazi itself, but rather the terminal. When users scroll quickly, Yazi processes the images at a very high speed and sends them to the terminal, but the terminal can't keep up with processing them in time, which gives the impression of lag. In reality, it's not Yazi that's lagging, but the terminal.#1512 introduces a new image_delay configuration option to address this issue. When previewing images, it will wait at least image_delay milliseconds before starting to send the decoded image data to the terminal.This gives the terminal a breather and creates the perception that the file list is still scrolling smoothly. Additionally, this can reduce the CPU overhead caused by immediate image decoding during fast scrolling, thereby extending battery life.Before:
Now:
New --dir option for the create command
The create command is designed to support creating both files and directories (with / or \ at the end to indicate a directory).However, this isn't user-friendly for those who need to create many directories but few files, as they always have to type / or \.#1505 (thanks to @abstrakct) introduces a new --dir option that explicitly specifies creating directories without needing to type / or \ every time.What's Changed
- fix: overlong single-line text containing escape sequences was not being properly escaped by @sxyazi in #1497
- fix: upgrade ansi-to-tui to 5.0.0-rc.1 to resolve ratatui version conflict by @sxyazi in #1499
- feat: add --dir option to create command by @abstrakct in #1505
- feat: add ext() method to Url userdata by @sxyazi in #1528
- feat: new confirm component by @thelamb in #1167
- chore: set MACOSX_DEPLOYMENT_TARGE to 10.11 to make the binary compatible with old macOS by @hronro in #1532
- fix: use a different cache directory for each user to avoid permission issues by @sxyazi in #1541
- fix: wait till mimetype is resolved to avoid flickering by @sxyazi in #1542
- docs: add links to all terminal emulators by @nyurik in #1538
- feat: make the builtin code previewer handle invalid carriage return chars and binary streams better by @sxyazi in #1550
- perf: only scan the first 1024 bytes to detect if it's binary, apply \r fixes only to content within the visible range, avoid unnecessary allocations during natural sorting by @sxyazi in #1551
- feat: word wrapping in builtin code preview by @ArtyomArtamonov in #1159
- fix: filter out the which candidates that overlap with longer key chords by @sxyazi in #1562
- fix: DECSET and DECRQM tmux passthrough by @sxyazi in #1564
New Contributors
- @abstrakct made their first contribution in #1505
- @hronro made their first contribution in #1532
- @nyurik made their first contribution in #1538
- @Art

After three months of development, I'm excited to announce the release of Yazi 0.3 today! This version brings a host of new features and bug fixes. Thank you to every contributor for making Yazi better and better!This is a breaking change release, so please make sure to read:
- Migrating to Yazi v0.3.0
- Packaging
- Lua API breaking changes in Yazi v0.3
Mouse support
The plugin system now includes five new APIs for each component - click, scroll, touch, move, and drag to handle mouse events. These APIs come with default implementations to cover common operations.This also allows plugin developers to extend mouse behavior and create any functionality they desire.See #1038 for more info, thanks to @qsdrqs for his work on this!New builtin extract plugin
#1321 adds a builtin extract plugin for decompressing archives, with these features:
1. Interactive password input.
2. Smart output directory selection with auto renaming.
3. Supports decompressing multiple files at once.
4. Fully async, decompression tasks can queue up and run in the background.
Enhanced file preview
Yazi 0.3 now supports the following new format to preview:
- Fonts
- SVGs
- HEIC files
- JPEG XL files
This feature requires the optional dependency ImageMagick to enable it.Package manager
Yazi 0.3 introduces the new ya pack subcommand for package management, making plugin and theme updates more convenient. This is especially important as the plugin system is not yet stable, so providing users with the ability to easily keep everything up to date is necessary.Add a new one to package.toml, then install it:
ya pack -a Reledia/glow

# If it's a sub-directory under the repository
ya pack -a yazi-rs/flavors#catppuccin-mocha

Install all packages configured in package.toml:
ya pack -i

Upgrade all packages in package.toml to the latest commit:
ya pack -u

See #985 for details.Redesigned Icons
#1086 redesigns the icons, bringing the following improvements:
- Improved Matching Performance: The new dirs, files, and exts compile the icon rules into a HashMap at startup. This allows most icon matches to be completed with O(1) complexity, significantly enhancing performance.
- Built-in nvim-web-devicons: This includes a richer and ready-to-use set of icons out of the box.
- Enhanced Icon Styling: Each icon now supports specifying both dark and light colors (currently only fg_dark is used). In the future, the terminal color will automatically choose the appropriate color. This was added as part of
- Enhanced is Function: The original is functionality has been reimplemented as conds to allow more complex conditional expressions, such as cond = "!dir & exec".
Significant archive preview performance improvements
#1220 reimplements archive previewing to be streamed. This means only a small amount of necessary data needs to be read to display the preview immediately, rather than waiting for all the data to be returned and parsed as before.Additionally, by replacing lsar with 7zip, the preview speed has been further improved. The new implementation also introduces two new features: icon display and file size display.Other improvements
These are a few of my favorite features. For a complete list of improvements in Yazi 0.3, check out the full changelog below.What's Changed
- feat: support yazi-cli for Nix flake by @XYenon in #944
- feat: allow building with the system Lua by @Kladki in #943
- feat: support expanding Windows paths like "D:" that only have a drive letter but no root by @sxyazi in #948
- fix: always create XDG cache directory even if user has set a custom one by @sxyazi in #956
- feat: support previewing files containing non-UTF-8 characters by @sxyazi in #958
- fix: correct the glob pattern for the icons to fit the new matching algorithm by @sxyazi in #959
- feat: add *.opus file icon by @Brixy in #967
- fix: improve accessibility by avoiding hex color code for white by @Brixy in #968
- fix: avoiding duplicate candidates in the which component by @mikavilpas in #975
- f