sxyazi

A blazing fast terminal file manager written in Rust, based on async I/O.

v26.9.1
Published at
Sep 1, 2026
43,386
Stars
624,779
Download
Synced at
10m ago

Latest release

v26.9.1Sep 1, 2026, 08:52 AM
Downloads slow? Switch the source anytime above

README

Project Overview

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.

Key Features

  • Full asynchronous support: all I/O operations are async, CPU tasks spread across multiple threads
  • Powerful async task scheduling and management
  • Built-in support for multiple image protocols, integrated with Überzug++ and Chafa
  • Built-in code highlighting and image decoding
  • Concurrent plugin system: UI plugins, functional plugins, custom previewers
  • Virtual filesystem: remote file management
  • Data distribution service: client-server architecture
  • Package manager: one-command plugin and theme installation
  • Integration with ripgrep, fd, fzf, zoxide
  • Vim-style components
  • Multi-tab support, cross-directory selection, scrollable preview
  • Bulk rename, archive extraction, visual mode
  • Theme system, mouse support, drag and drop, trash bin

Target Audience

  • Heavy terminal users and developers
  • Users seeking efficient file management
  • Users who like Vim-style operations

Quick Start

  1. Install via package managers: macOS brew install yazi, Linux via distribution package managers
  2. Or download binaries from GitHub Releases
  3. Launch: type yazi in the terminal
  4. Use Vim-style shortcuts to navigate and operate files
  5. View documentation: yazi --help

Core Advantages

  • Blazing fast with async I/O and multi-threading
  • Feature-rich, comparable to GUI file managers
  • Highly customizable with Lua plugin system
  • Modern features: image preview, Git integration, and more

System Requirements

  • OS: Cross-platform (macOS, Linux, Windows)
  • Architectures: x86_64, arm64
  • Additional Dependencies: None

Notes

  • Currently in public beta with potential breaking changes
  • Image preview requires terminal support for the corresponding image protocols

Release history

Sort