💥 Blazing fast terminal file manager written in Rust, based on async I/O. https://yazi-rs.github.io
Find a file
三咲雅 misaki masa 1537c15486
Some checks are pending
Cachix / Publish Flake (push) Waiting to run
Cachix / Publish Flake-1 (push) Waiting to run
Check / clippy (push) Waiting to run
Check / rustfmt (push) Waiting to run
Check / stylua (push) Waiting to run
Draft / build-unix (gcc-i686-linux-gnu, ubuntu-latest, i686-unknown-linux-gnu) (push) Waiting to run
Draft / build-unix (gcc-riscv64-linux-gnu, ubuntu-latest, riscv64gc-unknown-linux-gnu) (push) Waiting to run
Draft / build-unix (gcc-sparc64-linux-gnu, ubuntu-latest, sparc64-unknown-linux-gnu) (push) Waiting to run
Draft / build-unix (macos-latest, aarch64-apple-darwin) (push) Waiting to run
Draft / build-unix (macos-latest, x86_64-apple-darwin) (push) Waiting to run
Draft / build-unix (ubuntu-24.04-arm, aarch64-unknown-linux-gnu) (push) Waiting to run
Draft / build-unix (ubuntu-latest, x86_64-unknown-linux-gnu) (push) Waiting to run
Draft / build-windows (windows-latest, aarch64-pc-windows-msvc) (push) Waiting to run
Draft / build-windows (windows-latest, x86_64-pc-windows-msvc) (push) Waiting to run
Draft / build-musl (aarch64-unknown-linux-musl) (push) Waiting to run
Draft / build-musl (x86_64-unknown-linux-musl) (push) Waiting to run
Draft / build-snap (amd64, ubuntu-latest) (push) Waiting to run
Draft / build-snap (arm64, ubuntu-24.04-arm) (push) Waiting to run
Draft / snap (push) Blocked by required conditions
Draft / draft (push) Blocked by required conditions
Draft / nightly (push) Blocked by required conditions
Test / test (macos-latest) (push) Waiting to run
Test / test (ubuntu-latest) (push) Waiting to run
Test / test (windows-latest) (push) Waiting to run
Test / test-freebsd (push) Waiting to run
feat: percent-encoding modes and extra characters support
2026-09-29 20:57:21 +08:00
.cargo
.github
assets
nix
scripts
snap
yazi-actor feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-adapter fix: workaround Konsole kitty graphics and keyboard protocol bugs (#4370) 2026-09-22 07:10:46 +08:00
yazi-binding feat: percent-encoding modes and extra characters support 2026-09-29 20:57:21 +08:00
yazi-boot
yazi-build
yazi-cli feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-codegen
yazi-config feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-core
yazi-dds feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-emulator
yazi-ffi
yazi-fm
yazi-fs feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-macro
yazi-packing
yazi-parser
yazi-plugin feat: percent-encoding modes and extra characters support 2026-09-29 20:57:21 +08:00
yazi-proxy
yazi-runner feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-scheduler feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-sftp feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-shared feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-shim feat: percent-encoding modes and extra characters support 2026-09-29 20:57:21 +08:00
yazi-term fix: workaround Konsole kitty graphics and keyboard protocol bugs (#4370) 2026-09-22 07:10:46 +08:00
yazi-tty
yazi-tui
yazi-version
yazi-vfs feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-watcher feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
yazi-widgets
.envrc
.gitignore
.luarc.json
AGENTS.md fix: check smart case against raw filter input (#4379) 2026-09-29 00:34:08 +08:00
Cargo.lock feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
Cargo.toml feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
CHANGELOG.md feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
CODE_OF_CONDUCT.md
CONTRIBUTING.md
cspell.json feat: Rclone integration (#4383) 2026-09-29 01:11:55 +08:00
flake.lock
flake.nix
LICENSE
LICENSE-ICONS
README.md feat: percent-encoding modes and extra characters support 2026-09-29 20:57:21 +08:00
rustfmt.toml
stylua.toml

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 VFS provider, 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, Rclone
  • 💫 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 Rename/Create, Archive Extraction, Visual Mode, File Chooser, Git Integration, Mount Manager
  • 🎨 Theme System, Mouse Support, Drag and Drop, Trash Bin, Custom Layouts, CSI u, OSC 52, CSI 2031
  • ... 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

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

RustRover logo

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.