Skip to main content

Installation

To use Yazi, you must have the following prerequisites installed:

  • file (for file type detection)

Yazi can be optionally extended with other command line tools to enable additional features.

Packaging status

Packaging status

Arch Linux

sudo pacman -S yazi ffmpegthumbnailer unarchiver jq poppler fd ripgrep fzf zoxide

If you want to use the latest Git version, you can install it from AUR or Arch Linux CN:

paru -S yazi-git ffmpegthumbnailer unarchiver jq poppler fd ripgrep fzf zoxide

macOS

First, make sure that Homebrew is fully up-to-date with brew update.

Then you can install Yazi (and the optional dependencies):

brew install yazi ffmpegthumbnailer unar jq poppler fd ripgrep fzf zoxide
brew tap homebrew/cask-fonts && brew install --cask font-symbols-only-nerd-font

If you prefer to use the most recent code, use the --HEAD flag when installing Yazi.

brew install yazi --HEAD

Nix

A Nix package for Yazi is available.

# NixOS:
nix-env -iA nixos.yazi

# Not NixOS:
nix-env -iA nixpkgs.yazi

Or add the following to your configuration:

# configuration.nix
environment.systemPackages = with pkgs; [
yazi
];

You can also manage Yazi's configuration using home-manager.

MacPorts

sudo port install yazi ffmpegthumbnailer unar jq poppler fd ripgrep fzf zoxide

NetBSD

pkgin install yazi

Windows

Windows has been supported since Yazi v0.1.4, but it's still in the early stage, so please file an issue if you encounter any bugs.

Requirements

Yazi relies on file(1) to detect the mime-type of the file, and the easiest and most reliable way to get it on Windows is to install Git for Windows and use the file(1) that comes with it.

  1. Install Git for Windows by running the official installer, or through your package manager of choice.
  2. To allow Yazi to find file(1), add C:\Git_Installed_Directory\usr\bin\ to your %PATH% environment variable, which differs depending on how you installed Git:
    • If you installed Git with the installer, it would be C:\Program Files\Git\usr\bin.
    • If you installed Git with Scoop, it would be C:\Users\USERNAME\scoop\apps\git\current\usr\bin.
  3. Restart your terminal.

To check if you've done this properly, enter file -v, you should see output similar to the following:

C:\Users\yazi> file -v
file-5.45

This is the ONLY way we recommend. We do not recommend install it via Scoop or Chocolatey, since they cannot handle Unicode filenames (such as oliver-sjöström.jpg) properly and lack some required parameters.

Installation

You can download the latest official binaries from GitHub Releases, or install Yazi with Scoop:

scoop install yazi
# Install the optional dependencies (recommended):
scoop install unar jq poppler fd ripgrep fzf zoxide

Yazi on Scoop is maintained by community contributors, and may not always have the latest version available. You may need to check our GitHub Releases page for the latest version.

AOSC OS

sudo oma install yazi

Official binaries

You can download the latest official binaries from GitHub Releases.

Cargo

Setup the latest stable Rust toolchain:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup update

Now you can install yazi-fm from crates.io:

cargo install --locked yazi-fm

Or install the latest git version:

cargo install --locked --git https://github.com/sxyazi/yazi.git

If it fails to build, please check if make and gcc is installed on your system.

Build from source

Setup the latest stable Rust toolchain:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup update

Clone the repository and build Yazi:

git clone https://github.com/sxyazi/yazi.git
cd yazi
cargo build --release

Then, you can run:

./target/release/yazi

If it fails to build, please check if make and gcc is installed on your system.