mirror of
https://github.com/sxyazi/yazi.git
synced 2026-07-25 08:41:05 +00:00
💥 Blazing fast terminal file manager written in Rust, based on async I/O.
androidasyncioclicommand-lineconcurrencycross-platformdeveloper-toolsfile-explorerfile-managerfilesystemlinuxmacosneovimproductivityrustterminaltuivimwindows
5ea30fca5c
`yazi-widgets::Clear` delegates to `ratatui::widgets::Clear`, which only
resets cells inside the area. Two cases at the boundaries are not
handled:
- **Left edge.** A double-width glyph at `area.x - 1` keeps its full
two-cell visual width after the inner clear runs. Its right half
spills into `area.x`, sits underneath whatever the caller draws on
top, and renders as garbled overlap with the overlay's left border
or title. The bug is most visible on Windows Terminal with
directories whose names mix ASCII + CJK characters of an odd
parity, e.g. `abc一二三四五六七八九` — pressing `f` for the input
box or `w` for the task manager produces the screenshots in the
issue.
- **Right edge.** A double-width glyph whose left half sits at
`area.right() - 1` (inside the area, so it gets cleared) leaves
its continuation at `area.right()` (outside the area) as the empty
string ratatui's buffer model uses for continuations. The terminal
skips the empty cell and either renders stale content from the
previous frame in that column or paints the neighbour glyph
half-erased.
Patch both cells before delegating to the inner clear so the original
glyph widths are still visible to the check. Verified via five new
unit tests covering: left-edge double-width, left-edge single-width
(unaffected neighbour), right-edge continuation, right-edge with no
overhang (unaffected neighbour), and area touching the buffer edges
(no panic).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
||
|---|---|---|
| .cargo | ||
| .github | ||
| assets | ||
| nix | ||
| scripts | ||
| snap | ||
| yazi-actor | ||
| yazi-adapter | ||
| yazi-binding | ||
| yazi-boot | ||
| yazi-build | ||
| yazi-cli | ||
| yazi-codegen | ||
| yazi-config | ||
| yazi-core | ||
| yazi-dds | ||
| yazi-emulator | ||
| yazi-ffi | ||
| yazi-fm | ||
| yazi-fs | ||
| yazi-macro | ||
| yazi-packing | ||
| yazi-parser | ||
| yazi-plugin | ||
| yazi-proxy | ||
| yazi-runner | ||
| yazi-scheduler | ||
| yazi-sftp | ||
| yazi-shared | ||
| yazi-shim | ||
| yazi-term | ||
| yazi-tty | ||
| yazi-vfs | ||
| yazi-watcher | ||
| yazi-widgets | ||
| .envrc | ||
| .gitignore | ||
| .luarc.json | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| cspell.json | ||
| flake.lock | ||
| flake.nix | ||
| LICENSE | ||
| LICENSE-ICONS | ||
| README.md | ||
| rustfmt.toml | ||
| stylua.toml | ||
Special thanks to:
 Warp, built for coding with multiple AI agents Available for macOS, Linux and Windows |
|---|
Yazi - ⚡️ Blazing Fast Terminal File Manager
Yazi (means "duck") is a terminal file manager written in Rust, based on non-blocking async I/O. It aims to provide an efficient, user-friendly, and customizable file management experience.
💡 A new article explaining its internal workings: Why is Yazi Fast?
- 🚀 Full Asynchronous Support: All I/O operations are asynchronous, CPU tasks are spread across multiple threads, making the most of available resources.
- 💪 Powerful Async Task Scheduling and Management: Provides real-time progress updates, task cancellation, and internal task priority assignment.
- 🖼️ Built-in Support for Multiple Image Protocols: Also integrated with Überzug++ and Chafa, covering almost all terminals.
- 🌟 Built-in Code Highlighting and Image Decoding: Combined with the pre-loading mechanism, greatly accelerates image and normal file loading.
- 🔌 Concurrent Plugin System: UI plugins (rewriting most of the UI), functional plugins, custom previewer/preloader/spotter/fetcher; Just some pieces of Lua.
- ☁️ Virtual Filesystem: Remote file management, custom search engines.
- 📡 Data Distribution Service: Built on a client-server architecture (no additional server process required), integrated with a Lua-based publish-subscribe model, achieving cross-instance communication and state persistence.
- 📦 Package Manager: Install plugins and themes with one command, keeping them up-to-date, or pin them to a specific version.
- 🧰 Integration with ripgrep, fd, fzf, zoxide
- 💫 Vim-like input/pick/confirm/which/notify component, auto-completion for cd paths
- 🏷️ Multi-Tab Support, Cross-directory selection, Scrollable Preview (for videos, PDFs, archives, code, directories, etc.)
- 🔄 Bulk Renaming, Archive Extraction, Visual Mode, File Chooser, Git Integration, Mount Manager
- 🎨 Theme System, Mouse Support, Trash Bin, Custom Layouts, CSI u, OSC 52
- ... and more!
https://github.com/sxyazi/yazi/assets/17523360/92ff23fa-0cd5-4f04-b387-894c12265cc7
Project status
Public beta, can be used as a daily driver.
Yazi is currently in heavy development, expect breaking changes.
Documentation
Discussion
- Discord Server (English mainly): https://discord.gg/qfADduSdJu
- Telegram Group (Chinese mainly): https://t.me/yazi_rs
Image Preview
| Platform | Protocol | Support |
|---|---|---|
| kitty (>= 0.28.0) | Kitty unicode placeholders | ✅ Built-in |
| iTerm2 | Inline images protocol | ✅ Built-in |
| WezTerm | Inline images protocol | ✅ Built-in |
| Konsole | Kitty old protocol | ✅ Built-in |
| foot | Sixel graphics format | ✅ Built-in |
| Ghostty | Kitty unicode placeholders | ✅ Built-in |
| Windows Terminal (>= v1.22.10352.0) | Sixel graphics format | ✅ Built-in |
| st with Sixel patch | Sixel graphics format | ✅ Built-in |
| Warp (macOS/Linux only) | Inline images protocol | ✅ Built-in |
| Tabby | Inline images protocol | ✅ Built-in |
| VSCode | Inline images protocol | ✅ Built-in |
| Rio (>= 0.3.9) | Kitty unicode placeholders | ✅ Built-in |
| Black Box | Sixel graphics format | ✅ Built-in |
| Bobcat | Inline images protocol | ✅ Built-in |
| X11 / Wayland | Window system protocol | ☑️ Überzug++ required |
| Fallback | ASCII art (Unicode block) | ☑️ Chafa required (>= 1.16.0) |
See https://yazi-rs.github.io/docs/image-preview for details.
Special Thanks
Thanks to RustRover team for providing open-source licenses to support the maintenance of Yazi.
Active code contributors can contact @sxyazi to get a license (if any are still available).
License
Yazi is MIT-licensed. For more information check the LICENSE file.