yazi icon indicating copy to clipboard operation
yazi copied to clipboard

πŸ’₯ Blazing fast terminal file manager written in Rust, based on async I/O.

Yazi logo

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++, 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 always up to date, or pin them to a specific version.
  • 🧰 Integration with fd, rg, 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!

https://github.com/sxyazi/yazi/assets/17523360/92ff23fa-0cd5-4f04-b387-894c12265cc7

⚠️ Note: Yazi is currently in heavy development and may be unstable. The API is subject to change without prior notice.

Documentation

  • Usage: https://yazi-rs.github.io/docs/installation
  • Features: https://yazi-rs.github.io/features

Discussion

  • Discord Server (English mainly): https://discord.gg/qfADduSdJu
  • Telegram Group (Chinese mainly): https://t.me/yazi_rs

Image Preview

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.

License

Yazi is MIT-licensed. For more information check the LICENSE file.