sxyazi/yazi

💥 Blazing fast terminal file manager written in Rust, based on async I/O.

Source code at GitHub https://yazi-rs.github.io

{
  "createdAt": "2023-07-08T11:45:55Z",
  "defaultBranch": "main",
  "description": "💥 Blazing fast terminal file manager written in Rust, based on async I/O.",
  "fullName": "sxyazi/yazi",
  "homepage": "https://yazi-rs.github.io",
  "language": "Rust",
  "name": "yazi",
  "pushedAt": "2025-11-27T06:36:41Z",
  "stargazersCount": 30160,
  "topics": [
    "android",
    "asyncio",
    "cli",
    "command-line",
    "concurrency",
    "cross-platform",
    "developer-tools",
    "file-explorer",
    "file-manager",
    "filesystem",
    "linux",
    "macos",
    "neovim",
    "productivity",
    "rust",
    "terminal",
    "tui",
    "vim",
    "windows"
  ],
  "updatedAt": "2025-11-27T06:49:18Z",
  "url": "https://github.com/sxyazi/yazi"
}

^{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.
📡 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, Virtual Filesystem, 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

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 (>= 0.28.0)	[Kitty unicode placeholders][kgp]	✅ Built-in
iTerm2	[Inline images protocol][iip]	✅ Built-in
WezTerm	[Inline images protocol][iip]	✅ Built-in
Konsole	[Kitty old protocol][kgp-old]	✅ Built-in
foot	[Sixel graphics format][sixel]	✅ Built-in
Ghostty	[Kitty unicode placeholders][kgp]	✅ Built-in
Windows Terminal (>= v1.22.10352.0)	[Sixel graphics format][sixel]	✅ Built-in
st with Sixel patch	[Sixel graphics format][sixel]	✅ Built-in
Warp (macOS/Linux only)	[Inline images protocol][iip]	✅ Built-in
Tabby	[Inline images protocol][iip]	✅ Built-in
VSCode	[Inline images protocol][iip]	✅ Built-in
Rio	[Inline images protocol][iip]	❌ Rio renders images at incorrect sizes
Black Box	[Sixel graphics format][sixel]	✅ Built-in
Bobcat	[Inline images protocol][iip]	✅ Built-in
X11 / Wayland	Window system protocol	☑️ [Überzug++][ueberzug] required
Fallback	[ASCII art (Unicode block)][ascii-art]	☑️ [Chafa][chafa] required

See https://yazi-rs.github.io/docs/image-preview for details.

[kgp] !: https://sw.kovidgoyal.net/kitty/graphics-protocol/#unicode-placeholders [kgp-old] !: https://github.com/sxyazi/yazi/blob/main/yazi-adapter/src/drivers/kgp_old.rs [iip] !: https://iterm2.com/documentation-images.html [sixel] !: https://www.vt100.net/docs/vt3xx-gp/chapter14.html [ascii-art] !: https://en.wikipedia.org/wiki/ASCII_art

[ueberzug] !: https://github.com/jstkdng/ueberzugpp [chafa] !: https://hpjansson.org/chafa/

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]!(LICENSE) file.