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/fetcher; Just some pieces of Lua.
- ๐ก 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/select/which/notify component, auto-completion for cd paths
- ๐ท๏ธ Multi-Tab Support, Cross-directory selection, Scrollable Preview (for videos, PDFs, archives, directories, code, etc.)
- ๐ Bulk Renaming, Visual Mode, File Chooser
- ๐จ Theme System, Mouse Support, Trash Bin, Custom Layouts, CSI u
- ... and more!
example.mp4
- Discord Server (English mainly): https://discord.gg/qfADduSdJu
- Telegram Group (Chinese mainly): https://t.me/yazi_rs
Platform | Protocol | Support |
---|---|---|
kitty | Kitty unicode placeholders | โ Built-in |
Konsole | Kitty old protocol | โ Built-in |
iTerm2 | Inline images protocol | โ Built-in |
WezTerm | Inline images protocol | โ Built-in |
Mintty (Git Bash) | Inline images protocol | โ Built-in |
foot | Sixel graphics format | โ Built-in |
Ghostty | Kitty old protocol | โ Built-in |
Black Box | Sixel graphics format | โ Built-in |
VSCode | Inline images protocol | โ Built-in |
Tabby | Inline images protocol | โ Built-in |
Hyper | Inline images protocol | โ Built-in |
X11 / Wayland | Window system protocol | โ๏ธ รberzug++ required |
Fallback | ASCII art (Unicode block) | โ๏ธ Chafa required |
See https://yazi-rs.github.io/docs/image-preview for details.
Yazi is MIT-licensed. For more information check the LICENSE file.