Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog:

Added for new features.
Changed for changes in existing functionality.
Deprecated for soon-to-be removed features.
Fixed for any bug fixes.
Improved for performance improvements.

Unreleased

Added

Custom tab name (#3666)
New --in for search action to set search directory (#3696)
Multi-file spotter (#3733)
Vim-like lua action that runs an inline Lua snippet (#3813)
Certificate authentication for SFTP VFS provider (#3716)
New hovered condition specifying different icons for hovered files (#3728)
Allow using ps.sub() in init.lua directly without a plugin (#3638)
New ya.exec() API and ya exec subcommand to execute an action and await its result (#3780)
New sort_fallback option to control fallback sorting behavior (#3077)
New fs.access() API to access the filesystem (#3668)
New relay-notify-push DDS event to customize the notification handler (#3642)
New ind-app-title DDS event to customize the app title (#3684)
New ind-hidden and key-hidden DDS events to change hidden status in Lua (#3748)
New marker_symbol option to specify the symbol used for marking files (#3689)
New --discard for ya pkg that discard local changes made to packages (#3781)
New bulk_exit action that customizes the prompt for bulk operations (#3792)
New fs.unique() creates a unique file or directory (#3677)
New download DDS event fires when remote files are downloaded (#3687)
New ind-which-activate DDS event to change the which component behavior (#3608)
New hey DDS event fires when static messages are restored from persistence (#3725)
New cx.which API to access the which component state (#3617)
New experimental ya.co() API that creates a coroutine (#3757)

Changed

Upgrade Lua to 5.5 (#3633)
Change preset t for creating tabs to t ⇒ t to avoid conflict with new t ⇒ r for renaming tabs (#3666)
Remove title_format in favor of new ind-app-title DDS event for flexible title customization (#3684)
Remove micro_workers and macro_workers in favor of finer control over concurrent workers (#3661)

Deprecated

Deprecate fs.unique_name() in favor of fs.unique() to fix a TOCTOU race condition (#3677)

Fixed

Chafa v1.18.1 causes random ghost keypresses when previewing images (#3678)
Be a little defensive while parsing the output of 7zz -ba (#3744)
Make ya pkg ignore default remote name in user Git config (#3648)
Archive extraction fails for target paths with non-ASCII characters on Windows (#3607)
Escape backslashes in ImageMagick font path parameter (#3708)

Improved

Reduce memory allocations by using Lua 5.5 external strings (#3634)
Reuse previewed and spotted widgets when possible (#3765)
Avoid unnecessary allocations in code highlighting (#3804)

v26.1.22

Added

Tree view for the preset archive previewer (#3525)
Support compressed tarballs (.tar.gz, .tar.bz2, etc.) in the preset archive previewer (#3518)
Check and refresh the file list when the terminal gains focus (#3561)
Experimental module-level async support (#3594)
Disable ANSI escape sequences in ya pkg when stdout is not a TTY (#3566)
New Path.os() API creates an OS-native Path (#3541)

Fixed

Smart-case in interactive cd broken due to a typo (#3540)
Fix shell formatting for non-spread opener rules (#3532)
sort extension excludes directories since only files have extensions (#3582)
Account for URL covariance in Url:join() (#3514)

v26.1.4

Added

Support VFS for preset previewers that rely on external commands (#3477)
Support 8-bit images in RGB, CIELAB, and GRAY color spaces (#3358)

Fixed

ya pkg fails to write package.toml when the config directory does not exist (#3482)
A race condition generating unique filenames for concurrent file operations (#3494)

v25.12.29

Added

Remote file management (#3396)
Virtual file system (#3034, #3035, #3094, #3108, #3187, #3203)
Shell formatting (#3232)
Multi-entry support for plugin system (#3154)
Zoom in or out of the preview image (#2864)
Improve the UX of the pick and input components (#2906, #2935)
Show progress of each task in task manager (#3121, #3131, #3134)
New fs.copy() and fs.rename() APIs (#3467)
New experimental ya.async() API (#3422)
New overall option to set the overall background color (#3317)
Rounded corners for indicator bar (#3419)
New bulk_rename action always renames files with the editor (#2984)
key-* DDS events to allow changing or canceling user key events (#3005, #3037)
New --bg specifying image background color in the preset SVG and ImageMagick previewers (#3189)
filter by full path (prefix + filename) in search view instead of just filename (#2915)
New casefy action for case conversion of the input content (#3235)
Allow dynamic adjustment of layout ratio via rt.mgr.ratio (#2964)
Support .deb packages (#2807, #3128, #3209)
Port several widespread GUI keys to the input component (#2849)
Support invalid UTF-8 paths throughout the codebase (#2884, #2889, #2890, #2895, #3023, #3290, #3369)
Allow upgrading only specific packages with ya pkg (#2841)
Respect the user's image_filter setting in the preset ImageMagick previewer (#3286)
New duplicate DDS event for copying files (#3456)
New ind-sort and key-sort DDS events to change sorting in Lua (#3391)
Allow custom mouse click behavior for individual files (#2925)
Display newlines in input as spaces to improve readability (#2932)
Fill in error messages if preview fails (#2917, #3383, #3387)
Search view shares file selection and yank state (#2855)
Offload mimetype fetching on opening files to the task scheduler (#3141)
Increase terminal response timeout to better tolerate slow SSH network environments (#2843)

Changed

Rename name to url for open, fetchers, spotters, preloaders, previewers, filetype, and globs icon rules to support virtual file system (#3034)
Rename mime fetcher to mime.local, and introduce mime.dir fetcher to support folder MIME types (#3222)
Reclassify hovered and preview_hovered under [mgr] of theme.toml into [indicator] as current and preview, respectively (#3419)
Remove $0 parameter in opener rules to make the open action work under empty directories (#3226)
Return Path instead of Url from Url:strip_prefix() and File.link_to to enforce type safety (#3361, #3385)
Use body instead of the term content in confirmations (#2921)
Use u16 instead of u32 as the type of max_width and max_height options to avoid memory exhaustion (#3313)
Implement __pairs metamethod instead of __index for the callback argument of the @yank DDS event (#2997)

Deprecated

Deprecate $n, $@ (*nix) and %n, %* (Windows) in shell action and opener rules in favor of new shell formatting (#3232)
Deprecate ya.hide, ya.render, and ya.truncate in favor of ui.hide, ui.render, and ui.truncate (#2939)
Deprecate position property of ya.input() in favor of pos to align with ya.confirm() and its type ui.Pos (#2921)
Deprecate cx.tasks.progress in favor of cx.tasks.summary (#3131)
Deprecate frag properly of Url in favor of domain (#3034)
Deprecate ui.Rect.default in favor of ui.Rect {} (#2927)

Fixed

User-prepended open rules do not override presets (#3360)
Respect user's system media opener instead of hardcoding mpv (#2959)
Incorrect $0 and $@ parameters in shell action under empty directories (#3225)
Avoid appending a newline when reading clipboard contents (#3059)
Renew package rev only when it's empty (#3200)
Suspend only when there is a parent process (#3008)
Preserve open order for files with post-resolved MIME types (#2931)
A race condition in concurrent directory loading on a slow device (#3271)
Erase overlapping image portions when previewing errors (#3067)
Force Git checkout for plugin cache repositories (#3169)
Check compatibility when reusing previewer bytecode cache (#3190)
Disable kitty keyboard protocol on Windows due to crossterm inability to handle it (#3250)
Prevent quotes in file(1) arguments from being stripped under MSYS2 (#3364)
Expose ya CLI in the Snap build (#2904)
Fallback to PollWatcher for file changes watching on NetBSD (#2941)
Generate unique image IDs for Kgp to tolerate tmux (#3038)

Improved

Make copy, cut, delete, link, hardlink, download, and upload tasks immediately cancellable (#3429)
Make preload tasks discardable (#2875)
Reduce file change event frequency (#2820)
Upload and download of a single file over SFTP in chunks concurrently (#3393)
Do not listen for file changes in inactive tabs (#2958)
Switch to a higher-performance hash algorithm (#3083)
Sequence-based rendering merge strategy (#2861)
Store only Urn instead of full Url in find results (#2914)
Zero-copy UrlBuf to Url conversion (#3117)
String interning to reduce memory usage of mimetype and URL domain (#3084, #3091)
Do not pre-allocate memory for Lua tables (#2879)
Copy-on-write on command data, and avoid converting primitive types to strings thereby allocating memory (#2862)
Use AnyUserData::type_id() to reduce stack pushes (#2834)
App data instead of Lua registry to reduce stack pushes (#2880)

v25.5.31

Fixed

Expose ui.Wrap (#2810)
forward --end-of-word of the input should consider the mode's delta (#2811)
Make every effort to carry hidden states for dummy files (#2814)

v25.5.28

Added

Redesign tabs (#2745)
Support embedded cover for video preview (#2640)
Calculate real-time directory size in spotter (#2695)
Truncate long items in the file list (#2754, #2759, #2778)
Obscure input component for inputting passwords (#2675)
Improve path auto-completion results (#2765)
New ya pkg subcommand (#2770)
New ya.emit() API (#2653)
New fs.calc_size() API (#2691)
Allow custom exit code with quit --code (#2609)
New --hovered for the copy action (#2709)
s and S keybinds in the input component (#2678)
Limit memory usage for previewing large images (#2602)
Show error when image preview fails (#2706)
New ui.Align, ui.Wrap, and ui.Edge (#2802)
Make ui.Line renderable (#2743)
Checks in ya pub and ya emit subcommands to verify receiver exists and has necessary abilities (#2696)
Make the hover state for reveal, sort, and hidden actions stable (#2657)
New --no-dummy option for reveal action (#2664)
Fall back to CSI 16 t when PowerShell OpenSSH returns a fake terminal size (#2636)

Changed

Deprecate [manager] in favor of [mgr] to make it consistent with other APIs (#2803)
Remove tab_width as it no longer needs to be set manually (#2745)
Move tab_active and tab_inactive to a dedicated [tabs] section (#2745)
Remove sixel_fraction as it's no longer needed (#2707)

Deprecated

Deprecate ya.mgr_emit(), ya.app_emit() and ya.input_emit() (#2653)
Deprecate ya.preview_widgets() (#2706)
Deprecate the Command:args() method (#2752)
Deprecate the ya pack subcommand in favor of ya pkg (#2770)
Deprecate LEFT, CENTER, and RIGHT on ui.Line and ui.Text in favor of ui.Align (#2802)
Deprecate NONE, TOP, RIGHT, BOTTOM, LEFT, and ALL on ui.Bar and ui.Border in favor of ui.Edge (#2802)
Deprecate WRAP_NO, WRAP and WRAP_TRIM on ui.Text in favor of ui.Wrap (#2802)

Fixed

Respect the user's max_width setting in the preset video previewer (#2560)
Reverse the mixing order of theme and flavor configuration (#2594)
No title is set when starts the first time (#2700)
ya pub-to 0 checks if any peer is able to receive the message (#2697)
Detach background and orphan processes from the controlling terminal with setsid() (#2723)
Always try to create state directory before draining DDS data (#2769)
Avoid tmux interfering with kitty graphical sequences (#2734)

Improved

Double directory size calculation speed (#2683)
9x faster Sixel image preview (#2707)
Remove intermediate variables in natural sorting algorithm to avoid unnecessary allocation (#2764)
Avoid unnecessary memory allocation in ya.truncate() (#2753)

v25.4.8

Added

Enhance fzf integration (#2553)
Platform-specific key binding (#2526)
Custom search engine Lua API (#2452)
New follow action to follow files pointed to by symlinks (#2543)
Allow tab_swap to cycle tabs (#2456)
Show error message when directory fails to load (#2527)
New symlink_target to style the target of symbolic links (#2522)
Use Yazi in Helix directly without Zellij or tmux (#2461)
New <C-A> and <C-E> keybindings to select entire line for the input component (#2439)
New fs.expand_url() API (#2476)
New ui.Text:scroll() API for setting text to scroll horizontally or vertically (#2589)
Allow initializing input when opening it with actions like rename, create, find, filter, etc. (#2578)
New @sync peek annotation for sync previewers (#2487)
New ya.id("app") to get YAZI_ID in plugins (#2503)
New base field for the Url (#2492)
New rt.term exports terminal emulator information (#2442)
Allow bulk renaming to include trailing content in addition to the required new names (#2494)
Log tmux call execution time to logs (#2444)

Changed

Navigation wraparound with new arrow prev and arrow next actions (#2485, #2540)
Swap default key bindings for fzf and zoxide (#2546)
Switch to resvg as the SVG renderer (#2581)
Make frag, name, stem, ext, and parent on Url, name on tab::Tab, and is_hovered on fs::File properties (#2572)
Replace tasks_show and close_input with tasks:show and input:close (#2530)
Replace sync = true with the @sync peek annotation (#2487)

Deprecated

Deprecate ui.Padding and ui.Rect:padding() (#2574)

Fixed

Always show the size in the status bar even in empty directories (#2449)
Remove the temporary extraction directory forcefully (#2458)
Align the behavior of the end-of-options marker (--) with that of the shell (#2431)
Respect hidden status of directory junctions and symlinks themselves on Windows (#2471)

Improved

Rewrite config parser to double the startup speed (#2508)
Lazy compile and cache lua plugins as binary bytecode (#2490)
Faster image preview with optimized magick arguments (#2533)
Cache UserData fields (#2572)

v25.3.2

Added

Expose all theme fields in Lua (#2405)
Expose almost the entirety of the user's configuration in Lua (#2413)

Fixed

STDIN_FILENO poll always returns 0 under SSH (#2427)
Ignore stdin redirection to ensure always accessing the real tty (#2425)
Incorrect deprecation warning when the plugin doesn't exist (#2418)

v25.2.26

Added

Allow to specify layer for keymap actions (#2399)
New rt and th allow to access user configuration and theme scheme in sync/async plugins consistently (#2389, #2392, #2393, #2397)
New tbl_col and tbl_cell in theme system for spotter table styling (#2391)
Allow different separators to be applied individually to the left and right sides of the status bar (#2313)
ripgrep-all support for the search action (#2383)
Respect the user's max_width setting in the preset PDF preloader (#2331)
Respect the user's wrap setting in the preset JSON previewer (#2337)
Respect the user's image_alloc setting in the preset ImageMagick previewer (#2403)
New external and removable fields in the fs.partitions() API (#2343)
CSI-based Vim and Neovim built-in terminal detection for better accuracy (#2327)

Changed

Replace separator_open and separator_close with sep_left and sep_right (#2313)
Rename the [completion] component to [cmp] (#2399)

Deprecated

Deprecate MANAGER, PREVIEW, PLUGIN, and THEME in favor of rt and th (#2389)
Deprecate ya.manager_emit() in favor of ya.mgr_emit() (#2397)

Fixed

Didn't reset previous Cha when loading directories in chunks (#2366)
Load mount points with the best effort even if the /dev/disk/by-label directory does not exist (#2326)
Add maximum preview limit under /proc virtual file system (#2355)

v25.2.11

Added

New overall option under [status] to allow specifying the overall style of the status bar (#2321)
Reduce terminal response wait timeout (#2314)

Fixed

Unable to delete sealed files on Windows due to platform differences (#2319)
Reverse the order of CSI-based and environment-based terminal detection (#2310)

v25.2.7

Added

Mount manager (#2199)
New ya.confirm() API (#2095)
New arrow top and arrow bot actions to jump to the top and bottom (#2294)
Support end of options (--) marker for all actions (#2298)
Replace mode and Vim motions (W, E, B, ^, _) for inputs (#2143)
New ya pack -d subcommand to delete packages (#2181)
ya pack supports adding and deleting multiple packages at once (#2257)
Theme support for the spotter border and title (#2002)
Use positional argument instead of --args for the plugin action (#2299)
Support and hide Windows system files by default (#2149)
New --no-cwd-file option for the close action (#2185)
Prompt users missing fzf in the zoxide plugin (#2122)
More decent package locking mechanism (#2168)
Custom modal component API (#2205)
Support local tmux image preview over SSH
New @since plugin annotation to specify the minimum supported Yazi version (#2290)
Allow preloaders to return an optional Error to describe the failure (#2253)
ARM64 Snap package (#2188)
Support package.toml as a symlink (#2245)
New cx.layer API to determine the current UI layer (#2247)
Channel and multi-concurrent task join support for the plugin system (#2210)
Support application/mbox mimetype (#2173)
cbr and cbz as valid archive extensions (#2077)

Deprecated

Deprecate --args in the plugin action in favor of a 2nd positional parameter (#2299)
Deprecate plugin entry file init.lua in favor of main.lua (#2168)
Deprecate arrow -99999999 and arrow 99999999 in favor of arrow top and arrow bot (#2294)
Deprecate the numeric return value of preloaders in favor of a boolean return value (#2253)
Deprecate ya.md5() in favor of ya.hash() (#2168)

Fixed

before_ext excludes directories since only files have extensions (#2132)
Element style of ui.Text was not applied to the entire area (#2093)
Incorrect monorepo sub-plugin path resolution (#2186)
Use u32 for parsing Linux partition blocks (#2234)
Unmangle the hexadecimal space strings ("\x20") in Linux partition labels (#2233)
JSON value null should be deserialized as Lua nil, not lightweight userdata null (#2242)
Don't check if has a hovered file in advance, only do so when --hovered is explicitly specified (#2105)
Handle broken pipe errors gracefully (#2110)

Improved

Detach the watch registration from the main thread (#2224)

v0.4.2

Added

More supported archive formats to the preset config (#1926)
New fs.create() Lua API (#2068)
New --cwd parameter for the shell action and fs.cwd() API (#2060)
Allow noop for single-key chords by removing the mixing length limit (#2064)
Support for Android platform in the for qualifier of opener (#2041)

Fixed

Set the current working directory in a thread-safe way (#2043)
Interactive cd autocomplete doesn't follow the latest CWD changes (#2025)
Offset cursor shift when deleting multiple files in bulk (#2030)
Missing a render after resuming from an external blocking process (#2071)
Missing a hover after reordering from an external plugin (#2072)
Use a less intrusive DSR instead of DA1 workaround to forward terminal responses twice in tmux (#2058)
allow-passthrough must be set to on to prevent tmux from forwarding the real terminal's response to the inactive pane (#2052)

v0.4.1

Fixed

Correctly handle CRLF on Windows in preset archive and JSON plugins (#2017)
Failed to parse certain image dimensions for Überzug++ backend (#2020)
Disable passthrough when the user launches Yazi in Neovim inside tmux (#2014)

v0.4.0

Added

Spotter (#1802)
Support transparent image preview (#1556)
Auto switch between dark and light icons/flavors based on terminal backgrounds (#1946)
Allow disabling certain preset keybinds with the new noop virtual action (#1882)
New ya emit and ya emit-to subcommands to emit actions to a specified instance for execution (#1979)
Custom styles for the confirm component (#1789)
Make the builtin extract plugin support compressed tarballs (*.tar.gz, *.tar.bz2, etc.) (#1583)
Launch from preset settings if the user's config cannot be parsed (#1832)
Prioritize paths that need to be processed first during bulk renaming (#1801)
New copy --separator option to allow specifying the path separator (#1877)
Set a different input title for create --dir (#1650)
Include package revision hash in ya pack --list (#1884)
New load DDS event (#1980)
New log system (#1945)
New ui.Text and ui.Table layout elements (#1776)
Support passing arguments to previewer/preloader/spotter/fetcher (#1966)
Move notification from top-right to bottom-right corner to avoid covering content as much as possible (#1984)
Append the suffix to the end instead of start when generating unique filenames for directories (#1784)
Allow overriding and rewriting the sync methods of built-in plugins (#1695)
Fallback to CSI 16 t for certain terminals that do not support TIOCGWINSZ (#2004)
Support calling methods in built-in plugins with arbitrary types of arguments (self can now be omitted) (#1666)
Support assets installation for the ya pack subcommand (#1973)
Complete and consistent support for the ui.Style() API
Image ICC profiles for better color accuracy (#1808)
Support reading non-UTF8 data with Child:read_line() API (#1816)
New area() method for renderable elements (#1667)
yazi --debug supports detecting whether tmux is built with --enable-sixel (#1762)

Changed

Eliminate the x- prefix in MIME types (#1927)
Remove the vnd. prefix from mimetype to solve differences introduced in the newest file(1) v5.46 (#1995)
Rename the term select to toggle to reserve select for future use (#1773)
Correct the misuse of the term ctime and unify others (#1761)
Replace ffmpegthumbnailer with ffmpeg as the video preview backend to support spotter (#1928)
Use an Error userdata instead of a plain error code for I/O errors (#1939)
Remove ui.ListItem since it's no longer necessary (#1772)
Decouple coordinates from ui.List, ui.Bar, ui.Border, and ui.Gauge (#1782)
Make backspace action not close the input even when value is empty (#1680)
Remove the meaningless --confirm option to simplify the shell action (#1982)
Use dark and light instead of use under [flavor] to support auto-switching between light and dark modes (#1946)
Unify the fg_dark and fg_light into one fg since fg_light is redundant and never used (#1946)
Extend the available styles for mode by separating mode from the separator styles (#1953)

Deprecated

Deprecate --sync option for the plugin action (#1891)
Deprecate ui.Paragraph in favor of ui.Text (#1776)
Deprecate the task info of peek(), seek(), and preload() from self in favor of a job parameter (#1966)
Deprecate parameter list of entry() from its first argument in favor of a job parameter (#1966)
Deprecate the number of units of seek() from its first argument in favor of a job parameter (#1966)

Fixed

Introduce a new btime term to align ctime with Unix (#1761)
Match icon by extension case-insensitively (#1614)
Copy the CWD path with c => d regardless even if the directory is empty (#1849)
Respect the image_quality setting in preset PDF previewer (#2006)
Images were not cleared when closing a tab in front of the current tab (#1792)
Replace control characters to printable characters in plain text preview (#1704)
One file's MIME type changed multiple times without triggering a preview again (#1682)
Reset image rendering and skip peeking if the TUI in the background (#1833)
File upserting should handle deleting in edge cases where the source and target URNs are different (#1737)
Revise revision if the new file list is empty but the previous one was not (#2003)
Update rustix to fix the enable_raw_mode() error on WSL/Android

Improved

Merge multiple file operations into one to greatly speed up updates in large directories (#1745)
Eliminate all memory reallocations during sorting (#1846)
Introduce URN to speed up large directory sorting, updating, locating (#1622, #1652, #1648)
Improve jemalloc memory allocator efficiency (#1689)
Lazy load ui, ya, fs, and ps (#1903)
Avoid unnecessary allocations in base64 encoding of inline image protocol (#1639)
Introduce copy-on-write for event system to eliminate all memory reallocations (#1962)
Apply rotate in place to images with orientation (#1807)
Introduce reflow for the rendering engine (#1863)

v0.3.3

Added

size linemode supports showing the file count for directories (#1591)
Support image preview in Windows Terminal (#1588)
Add is_absolute, has_root, starts_with, ends_with, strip_prefix to Url (#1605)

Fixed

Keybindings disappear when mixing presets with a wrong filter condition (#1568)
Squeeze offset of the file list after resizing window (#1500)
Check compositor support status before using ueberzug wayland output (#1566)
Fallback to PollWatcher for file changes watching on WSL (#1574)

Improved

Truncate long lists in confirm dialogs (#1590)

v0.3.2

Added

New confirm component (#1167)
Word wrapping in code previewer (#1159)
New --dir option for create action (#1505)
New ext() method for Url (#1528)
Make the builtin code previewer handle invalid carriage return chars and binary streams better (#1550)

Fixed

Wait till mimetype is resolved to avoid preview flickering (#1542)
Use a different cache directory for each user to avoid permission issues (#1541)
Filter out candidates that overlap with longer key chords from the which component (#1562)
Overlong single-line text preview containing escape sequences was not being properly escaped (#1497)

Improved

New image_delay option debounces image previews to avoid lag caused by terminal image decoding during fast scrolling (#1512)
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 (#1551)

v0.3.1

Added

Start with multiple tabs with different paths (#1443)
Key notion shorthands such as <C-S-x> as <C-X> (#1448)
Support F13 - F19 keys (#1446)
New --cursor for the shell action (#1422)
New search_do action to make it easier to achieve a flat view (#1431)
Portrait orientation preview for EXIF image (#1412)
Keybinding for the hardlink action (#1461)
New empty previewer for empty and /proc/* files (#1482)
Note about filtering in the help menu (#1361)
New tab DDS event on tab switch (#1474)
New status() method for Command (#1473)

Fixed

Directory loading status (#1439)
Resolve relative path when expanding path (#1428)
DDS static messages only work when at least two instances are running (#1467)
Escape files containing special \x1b characters and render it as plain text (#1395)
7zip shows different error messages for wrong password (#1451)
7zip shows different error messages for RAR and ZIP files (#1468)
Newly created directories with the same name causing a false positive in directory loading optimization due to having the same modification time (#1434)
Close stdin before waiting for child process (#1464)

v0.3.0

Added

Package manager (#985, #1110)
Support mouse event (#1038, #1139, #1232)
New extract built-in plugin for archive extracting (#1321)
Redesign icons (#1086)
Font preview (#1048)
SVG, HEIC, AVIF, and JPEG XL preview support (#1050, #1249)
Simplify keybindings (#1241)
New hardlink action to create hard links (#1268)
Keep file creation time on macOS and Windows (#1169)
Sort randomly (#1291)
New linemode to show file ownership (#1238)
New linemode to show file ctime (#1295)
New --hovered option for the rename and remove actions (#1227)
Support Super/Command/Windows key with D- notation (#1069)
Interactive cd path auto-completion supports ~ expansion (#1081)
Preview files containing non-UTF-8 characters (#958)
Expand Windows paths like "D:" that only have a drive letter but no root (#948)
Close confirmation dialogs and exit automatically when the ongoing task gone (#997)
Case-insensitive special keys in keymappings (#1082)
Transliteration for natural sorting (#1053)
New ya.clipboard() API (#980)
New debounce option for the ya.input() API (#1025)
Support yazi-cli for Nix flake (#944)
Support stdin and pipe for Child API (#1033)
New ya sub subcommand to subscribe to DDS events (#1004)
Allow specifying $YAZI_ID with a command-line argument (#1305)
DDS client-server version check (#1111)
New bulk DDS event (#937)
Support cargo binstall yazi-fm and cargo binstall yazi-cli (#1003)
Show ya CLI version in the yazi --debug output (#1005)
Detect terminal type in tmux with CSI sequence in passthrough mode (#977)

Changed

Use Ctrl+c instead of Ctrl+q as the universal close key to follow the conventions
Replace Alt+k/Alt+j with K/J as the seek keybindings to avoid Alt key not working in certain terminals
Replace Ctrl+Enter with Shift+Enter as the alternative key for Shift+o so that it corresponds to Enter being o (without Shift)
keep original state of sort action in favor of specifying yes or no to explicitly apply a new state to its --reverse, --dir-first, and --translit
Move mime plugin from [plugin.preloaders] to [plugin.fetchers] of yazi.toml
Turn success and code into properties of Status instead of methods
Remove fs.cha_follow(url) in favor of fs.cha(url, true)
Rename is_block_device, is_char_device, and is_socket of Cha to is_block, is_char, and is_sock for simplicity

Fixed

Different filenames should be treated as the same file on case-insensitive file systems (#1151)
Suppress warnings for different name representations of the same file in the case-insensitive file system when renaming (#1185)
Avoid duplicate candidates in the which component (#975)
Sixel support from certain st forks cannot be detected (#1094)
Move the DDS socket file out of the cache directory to avoid being affected by yazi --clear-cache
Build jemalloc with 64KB pagesize on linux/arm64 (#1270)
Cursor gets out of sync occasionally at image previewing through IIP under tmux (#1070)

Improved

Reimplement and significantly speed up archive previewing (#1220)

v0.2.5

Added

Data distribution service (#826, #855, #861, #867, #868, #871, #880, #895, #913, #928, #933, #940)
Re-implement fzf and zoxide as built-in plugins (#884, #881)
Preserve files' modified at timestamp while copying (#926)
New --orphan option for shell action (#887)
Smart-case for completion of interactive cd paths (#910)
Allow creating a tab with the startup directory through tab_create without specifying a path (#917)
Bunch of new debugging information to yazi --debug (#824)
Time-based selection order preservation (#843)
Placeholder message when there are no files in the list (#900)
Enhance ya.dbg() and ya.err() by support arbitrary types (#835)
Trigger path completion with both / and \ on Windows (#909)
Allow opening interactively with the --chosen-file flag (#920)
Support YAZI_FILE_ONE in the preset file previewer (#846)

Deprecated

Deprecate the jump action in favor of plugin fzf and plugin zoxide (#884, #881)

Fixed

Kill all spawned processes on exit (#812)
Prevent pasting a directory into itself (#925)
Use BTreeSet for selected files to maintain order (#799)
CJK text rendering issue where the input popup component overlaps with images (#879)

Improved

Accelerate kitty graphics protocol encoding by avoiding string reallocation (#837)
Wrap stderr with BufWriter to avoid frequent system calls thereby increase rendering frame rate (#849)
Switch to globset to reduce CPU time spent on matching icons (#908)
Re-implement file watcher in an async way (#877)
Cache each file's icon to avoid redundant calculations at rendering (#931)
Port require() and ya.sync() to Rust to avoid plugin information initialization (#853)

v0.2.4

Added

Vim-like notification with new ya.notify() API (#659, #749, #780)
New ya.input() API to request user input (#762)
Cross-directory selection (#693)
Colorize the icons (#683)
Flavors (#753)
New counter component shows the number of yanked/selected items (#646)
New scrolloff option to keep a margin when scrolling (#679)
New <Home>, <End>, and <Delete> keybindings for inputs (#665)
New <C-p> and <C-n> for the select component to move the cursor up/down (#779)
New Ctrl+[ as an alternative to the escape key (#763)
New option --hovered for the open action allows only to open the currently hovered file (#687)
Support musl builds for Linux (#759)
New --debug flag to print debug information (#794)
Send a foreground notification to the user when the process fails to run (#775)
Nested conflict detection for cross-directory selections (#689)
New prepend_rules and append_rules for [open] and [icon] (#754, #670)
Call sync functions within an async plugin (#649)
Allow access to complete app data from all tabs (#644)
Ability to sort candidates in the which component (#662)
Expose selected/yanked files as Lua API (#674)
New cx.yanked API to access yanked files (#788)
New $0 (Unix) / %0 (Windows) to access the hovered file in shell action (#738)
New ya.hide() API to hide the UI temporarily (#792)
Allow both / and \ for folder creation on Windows (#751)
New parse() method for the line elements to parse ANSI sequences
New ui.Clear component to clear areas (#786)
Support YAZI_FILE_ONE environment variable for file(1) path (#752)
Merge wildcard preloader and previewer rules via append_preloaders and append_previewers

Deprecated

Deprecate the exec property in yazi.toml, keymap.toml, and theme.toml in favor of run

Fixed

Rendering fails when no file type style is matched (#721)

Improved

Cache loaded plugins (#710)
Cheaper sync context initialization (#643)
Prefer raw_get() and raw_set()

v0.2.3

Added

Preview image over SSH (#585)
New unyank action (#313)
Customize number of columns of the which component (#571)
Support passing arguments to plugin (#587)
New image_quality and sixel_fraction options to configure the image preview quality (#576)
New ya.which() API for custom key events (#617)
New ya.quote() API to quote strings safely
plugin action for each layer
Plugin-specific state persistence (#590)
Allow to configure image filter (#586)
Shorten unit names and add more units to ya.readable_size()
Support char device in [filetype] (#628)
File hidden attributes on Windows (#632)
Make trash crate optional on Android (#600)

Fixed

Parent folder not tracking CWD (#581)
Input offset is not reset when renaming with --cursor=start and the filename is too long (#575)

Improved

Read directory in bulk in the background at startup (#599)
Lazy sorting when loading large directories to reduce CPU consumption (#607)

v0.2.2

Added

prepend_keymap and append_keymap for configuration mixing (#546)
file(1) as the file fallback previewer (#543)
Submit both completion and input with a single press of enter (#565)
Allow the spawned child processes to suspend (#556)
New ya.host_name() API (#550)
Desktop entry and logo (#534)
Snap package (#531)
Support Windows ARM64 (#558)
Image preview in Tabby terminal (#569)

Fixed

Can't display file name with invalid UTF-8 (#529)

Improved

New event system allows multiple actions to reuse a single render (#561)

v0.2.1

Fixed

Renaming may cause a crash when encountering Unicode characters (#519)

v0.2.0

Added

New filter action to filter files on the fly (#454)
Sort by file extension (#405)
Custom preloader and previewer (#401)
New plugin action to run Lua plugins
Auto-completion for input component (#324, #353, #352)
Start with the specified file hovers over (#358)
Emacs readline keybindings for inputs (#345, #382)
New --empty and --cursor options for the rename action (#513)
New --follow option for paste action (#436)
Make copy action work over SSH with OSC 52 (#447)
New reveal action (#341)
Support colored icons (#503)
Support highlighting specific file types (#510)
Make the position of input and select components customizable (#361)
New prepend_preloaders, append_preloaders, prepend_previewers, append_previewers options for configuration mixing
Cursor and page key navigation parity with Vim bindings (#386)
Use terminal ANSI colors for code highlighting by default
New image_alloc and image_bound options to control image preview memory usage (#376)
New suppress_preload option to hide preload tasks (#430)
New kitty graphics protocol implementation for better compatibility with tmux through Unicode placeholders (#365)
New ya.user_name() and ya.group_name() API (#469)
New ya.render() to trigger a UI render
Image orientation support (#488)
Raise open file descriptors limit at startup (#342)
Support image preview on WSL (#315)
Fine-grained scheduling priority (#462)
New YAZI_LEVEL environment variable to indicate the nested level (#514)
New QuadrantInside and QuadrantOutside border type

Changed

Rename the option layout to ratio to make it more self-explanatory
Rename the peek action to seek to better convey the action of "seeking for" content to preview
Rename the --dir_first option of sort action to --dir-first to make it consistent with the style of other actions
Replace [plugins.preload] with the init.lua entry file

Fixed

jq previews empty when the user sets tab_size=8 (#320)
Precache n-1 and n+1 pages (#349)
Popup components being covered by previewed images (#360)
Rust panics instead of returning an error when file times are invalid (#357)
Clear Sixel image with empty characters instead of \x2B[K to be compatible with GNOME VTE (#309)
Use WAYLAND_DISPLAY and DISPLAY to detect Wayland/X11 when XDG_SESSION_TYPE is not set (#312)

Improved

Chunk loading for MIME types (#467)
Fallback to plain highlighter for long text (#329)
Reduce peak memory footprint during decoding large images (#375)
Clear only necessary cells when hiding images (#369)
New UI rendering architecture (#468)
Partial rendering progress and composite into a complete UI to reduce CPU consumption caused by frequent progress updates (#509)

v0.1.5

Added

New find action to find files (#104)
Linemode to show extra file info (#291)
New sort_sensitive option (#155)
Cross-platform opener rules (#289)
Multiple openers for a single open rule (#154)
Vim-like gg, G in the preset key mappings for boundary jumps
Theme system (#161)
New --force option for remove, create, rename actions (#179, #208)
Image preview within tmux (#147)
New link action creates symlinks to the yanked files (#167)
New orphan option for opener rules to detach processes from the task scheduler (#216)
New backward and forward actions
New --smart option for the find action to support smart case (#240)
Sorting for each tab individually (#131)
Suspend process with Ctrl+z (#120)
Percentage values for the arrow action to scroll half/full page (with newly added Vi-like <C-u>, <C-d>, <C-b>, and <C-f> keybindings) (#213)
Show keywords when in search mode (#152)
Tab switch wraparound (#160)
Highlight matched keywords in find mode (#211)
Customizable main UI border styles (#278)
<BackTab> key notion (#209)
Use of environment variables in cd paths (#241)
Nix Flakes package (#205)
New V, D, C Vim-like keybindings for the input component
New --no-cwd-file option for the quit action to exit without writing the CWD file (#245)
Fallback to built-in code highlighting if jq is not installed (#151)
New realtime option for the input to support real-time input feedback (#127)
RGBA-16 image preview (#250)
FreeBSD and NetBSD support (#169, #178)
Trash files on NetBSD (#251)
Image preview support on Mintty (Git Bash) terminal

Changed

Make glob expressions case-insensitive by default (with new \s for sensitive) (#156)
Make help items filtering case-insensitive

Fixed

show_hidden not properly applied to hovered folder (#124)
Notification of file changes in linked directories (#121)
Restore default cursor style when closing input from insert mode
Task manager cursor position not reset after task cancellation
Redirect clipboard process' stderr to /dev/null
Delegate the SIGINT signal of processes with orphan=true to their parent (#290)
Inconsistent Shift key behavior on Unix and Windows (#174)

Improved

Load large folders in chunks (#117)
Reimplemented natural sorting algorithm for ~6x faster case-insensitive sorting
Kill process immediately after getting enough JSON or archive preview content to avoid wasting CPU resources (#128)

v0.1.4

Added

Help menu (#93)
Scrollable preview (#86)
Natural sorting (#82)
Windows support
New copy action to copy file paths to clipboard (#72)
File chooser mode (#69)
Show symlink path (#67)
Respect $EDITOR environment variable when opening text files (#91)
Customizable main UI layout ratio (#76)
Allow accessing selected files when running shell commands (#73)
Update MIME type when file changes are detected (#78)
More clipboard backend: xclip and xsel, and Windows (#74, #75)
New cache_dir option (#96)
New YAZI_CONFIG_HOME to specify the configuration directory (#97)
Black Box terminal image preview support (#99)

Deprecated

Deprecate --cwd in favor of the positional argument (#100)

Fixed

Make file(1) follow symbolic links when fetching file MIME type (#77)
Wrong height of the select component (#65)
Regression causing UI tearing when previewing images
Specify doNotMoveCursor to make WezTerm render images sensibly

v0.1.3

Added

Bulk rename (#50)
PDF preview and precache (#18)
New sort_dir_first option (#49)
Code highlighting supports more languages (#22)
Change the shell CWD on exit with the shell wrapper (#40)
Allow customizing the display name of openers (#31)
New shell action (#24)
Command template support for the shell action (#48)
Interactive cd (#43)
Show the output of running tasks in real time (#17)
Allow using the current directory name as tab name (#41)
Custom status bar separator (#30)
Fallback for opening files when no openers are available
Preview files with inode/empty and application/json MIME types
Transparent image support for the Sixel backend (#14)
Refresh image preview after terminal restoration
New micro_workers, macro_workers, and bizarre_retry options to control task concurrency (#53)

Fixed

PDF cache cannot be generated with a large max_width value (#28)
show_hidden option not working (#47)
Wrong task name when shell action has no arguments

Improved

Make code highlighting discardable (#20)
Improved performance of highlighting large JSON files (#23)
Wrap stdout with BufWriter to improve image preview performance (#55)
Improved bulk rename performance (#54)

v0.1.2

Added

New sort action to change sorting method on the fly (#7)
Which-key component to support multi-key chords (#4)
Hover the cursor over newly created files automatically (#10)
Make folders openable (#9)
Several default goto key mappings
Support Überzug++ as the image preview backend for X11/Wayland (#12)
Cut input content to the system clipboard (#6)
Input component supports undo for cursor position
Support for bracketed paste (#5)

Improved

Cache directory size to avoid redundant calculations (#11)

v0.1.1

Added

Arrow keys are now bound for navigation by default (along with existing Vim-style bindings)
Horizontal scrolling support for the input component
Visual mode for the input component
New yank and paste actions for the input component
New undo and redo actions for the input component

Fixed

Cannot delete the last character of the input if at the end of the word

Improved

Decode images in a dedicated blocking thread to avoid blocking the UI

v0.1.0

Added

Preset configurations
New open action
Select component for interactive open
Plain text and archive preview
Search files with fd and rg
Jump around with fzf and zoxide
Flat view for search results
Precache images and videos
Return to its parents if the CWD no longer exists
Confirm when deleting files or exiting
Custom status bar colors

Fixed

Build errors on Linux
Number of remaining tasks cannot be updated

FilesExpand file tree

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Changelog

Added

Changed

Deprecated

Fixed

Improved

Added

Fixed

Added

Fixed

Added

Changed

Deprecated

Fixed

Improved

Fixed

Added

Changed

Deprecated

Fixed

Improved

Added

Changed

Deprecated

Fixed

Improved

Added

Fixed

Added

Changed

Deprecated

Fixed

Added

Fixed

Added

Deprecated

Fixed

Improved

Added

Fixed

Fixed

Added

Changed

Deprecated

Fixed

Improved

Added

Fixed

Improved

Added

Fixed

Improved

Added

Fixed

Added

Changed

Fixed

Improved

Added

Deprecated

Fixed

Improved

Added

Deprecated

Fixed

Improved

Added

Fixed

Improved

Added

Fixed

Improved

Fixed

Added