Repolode
Submit
sxyazi

sxyazi/yazi

A terminal file manager written in Rust, built on non-blocking async I/O with image preview, Lua plugins and a vim-like interface.

Open-source alternative to:FinderWindows ExplorerTotal Commander

View on GitHubWebsite
Stars
42,948
Forks
1,052
Open issues
67
Last commit
15 hours ago

What is it?

Yazi is a terminal file manager written in Rust. All of its I/O operations are asynchronous, and CPU-bound work is spread across multiple threads, so browsing and previewing stay responsive in large directories.

It supports previews for images, videos, PDFs, archives, code and directories through several terminal image protocols, including kitty, iTerm2, WezTerm, Sixel-capable terminals, with Überzug++ and Chafa as fallbacks on other systems. Users can extend it with Lua plugins for the UI, previewers, and custom file operations, and install plugins and themes through a built-in package manager.

Day-to-day features include multiple tabs, bulk rename, archive extraction, visual selection, trash bin support, mouse input and drag and drop. It integrates with ripgrep, fd, fzf and zoxide, and the project describes itself as in public beta and suitable for daily use.

Key features

  • 01Fully asynchronous I/O with multi-threaded CPU task handling
  • 02Image previews via kitty, iTerm2, WezTerm, Sixel and other terminal protocols
  • 03Lua plugin system for UI, previewers and file functions
  • 04Built-in package manager for installing and updating plugins and themes
  • 05Multi-tab browsing, bulk rename, archive extraction and trash bin support
  • 06Integration with ripgrep, fd, fzf and zoxide

Use cases

  • Navigating and previewing files over SSH in a terminal-only environment
  • Managing large directories where a responsive file browser matters
  • Pairing a keyboard-driven file manager with Neovim or other terminal workflows
  • Customizing file browsing behavior through Lua plugins

Things to know

  • The project is in public beta and is under heavy development, so breaking changes are expected.
  • Image preview on X11, Wayland and fallback terminals needs extra tools (Überzug++ or Chafa).

Topics

#terminal#file-manager#rust#tui#async-io#cli#neovim#lua-plugins#android#asyncio

FAQ

What is yazi?
A terminal file manager written in Rust, built on non-blocking async I/O with image preview, Lua plugins and a vim-like interface. Yazi is a terminal file manager written in Rust. All of its I/O operations are asynchronous, and CPU-bound work is spread across multiple threads, so browsing and previewing stay responsive in large directories.
Is yazi free to use? What license does it have?
yazi is open source under the MIT license. Check the license terms before using it in commercial products.
Is yazi still maintained?
Actively maintained. The last commit to yazi was on Oct 20, 2026.
What can I use yazi for?
Navigating and previewing files over SSH in a terminal-only environment Managing large directories where a responsive file browser matters Pairing a keyboard-driven file manager with Neovim or other terminal workflows Customizing file browsing behavior through Lua plugins
Where can I get yazi?
The source code and installation instructions are on GitHub: https://github.com/sxyazi/yazi

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects