GStars
    sxyazi

    sxyazi/yazi

    #93 this week

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

    android
    cli
    mobile
    developer-tools
    ios
    asyncio
    command-line
    concurrency
    cross-platform
    file-explorer
    Rust
    MIT
    40.1K stars
    923 forks
    40.1K GitHub watchers
    Updated 7/6/2026
    View on GitHub

    Backblaze Generative Media Hackathon

    Build the next generation of AI media apps with Genblaze, stored on Backblaze B2. $10,000 in prizes.

    Enter the hackathon

    Loading star history...

    Use Cases & Benefits

    • Provides a blazing fast terminal file manager using asynchronous I/O and Rust for efficient, user-friendly file management.
    • Delivers high performance through full async support, multi-threaded CPU task distribution, and real-time task management.
    • Use for managing files efficiently in terminal environments across Linux, macOS, and Windows with async concurrency.
    • Use for integrating advanced image previews and code highlighting directly within terminal file browsing workflows.
    • Use for extending file manager capabilities with Lua-based plugins, custom previews, and cross-instance state synchronization.

    About yazi


    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

    Discussion

    Image Preview

    PlatformProtocolSupport
    kitty (>= 0.28.0)Kitty unicode placeholders✅ Built-in
    iTerm2Inline images protocol✅ Built-in
    WezTermInline images protocol✅ Built-in
    KonsoleKitty old protocol✅ Built-in
    footSixel graphics format✅ Built-in
    GhosttyKitty unicode placeholders✅ Built-in
    Windows Terminal (>= v1.22.10352.0)Sixel graphics format✅ Built-in
    st with Sixel patchSixel graphics format✅ Built-in
    Warp (macOS/Linux only)Inline images protocol✅ Built-in
    TabbyInline images protocol✅ Built-in
    VSCodeInline images protocol✅ Built-in
    RioInline images protocol✅ Built-in
    Black BoxSixel graphics format✅ Built-in
    HyperInline images protocol✅ Built-in
    BobcatInline images protocol✅ Built-in
    X11 / WaylandWindow system protocol☑️ Überzug++ required
    FallbackASCII 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.

    Discover Repositories

    Search across tracked repositories by name or description