💥 Blazing fast terminal file manager written in Rust, based on async I/O.
Find a file
Yuval Spiegel 7259a116d6
fix(adapter): use unique foreground colors for Unicode placeholders in tmux
When running multiple Yazi instances in tmux panes, all instances show
the same image preview. This happens because the Unicode placeholder
implementation uses a hardcoded foreground color RGB(0,0,1) for all
instances.

In the Kitty graphics protocol's Unicode placeholder system, the
foreground color of the placeholder characters encodes the image ID.
Since all instances used the same color, they all had the same image ID,
causing tmux to display the same image in all panes.

Changes:
- Generate a unique image ID per Yazi instance based on process PID
- Encode this ID in the RGB foreground color of Unicode placeholders
- Each instance now has a unique color/ID, preventing image overlap
- Delete only the instance's specific image by ID

This properly implements the Unicode placeholder specification where
the foreground color serves as the image identifier.

Fixes the issue where multiple Yazi instances in tmux would display
the same image.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-04 21:36:50 +08:00
.cargo fix: avoid appending a newline when reading clipboard contents (#3059) 2025-08-14 11:26:46 +08:00
.github feat: introduce the concept of Uri (#3049) 2025-08-13 01:38:43 +08:00
assets feat: add desktop entry and logo (#534) 2024-01-18 00:46:04 +08:00
nix fix: Darwin framework deprecation in Nix build (#3119) 2025-08-28 23:26:01 +08:00
scripts feat: support VFS for join(), starts_with(), and ends_with() of Url (#3094) 2025-08-23 23:06:11 +08:00
snap feat: introduce the concept of Uri (#3049) 2025-08-13 01:38:43 +08:00
yazi-actor feat: port task manager to Lua (#3134) 2025-09-03 22:25:16 +08:00
yazi-adapter fix(adapter): use unique foreground colors for Unicode placeholders in tmux 2025-09-04 21:36:50 +08:00
yazi-binding feat: port task manager to Lua (#3134) 2025-09-03 22:25:16 +08:00
yazi-boot refactor: Url::pair() without allocation (#3116) 2025-08-27 23:52:09 +08:00
yazi-build fix: respect URL covariance when updating mimetypes (#3079) 2025-08-18 23:20:03 +08:00
yazi-cli feat: tasks without progress (#3131) 2025-09-02 16:58:34 +08:00
yazi-codegen feat: make mimetype matching more robust (#3082) 2025-08-19 15:17:32 +08:00
yazi-config feat: progress of each task (#3121) 2025-09-04 18:55:28 +08:00
yazi-core feat: progress of each task (#3121) 2025-09-04 18:55:28 +08:00
yazi-dds feat: port task manager to Lua (#3134) 2025-09-03 22:25:16 +08:00
yazi-ffi feat: zoom in or out of the preview image (#2864) 2025-06-11 15:24:11 +08:00
yazi-fm fix: Windows path length may exceed MAX_PATH (#3137) 2025-09-04 17:02:18 +08:00
yazi-fs fix: Windows path length may exceed MAX_PATH (#3137) 2025-09-04 17:02:18 +08:00
yazi-macro refactor: simplify cursor repositioning (#3040) 2025-08-08 02:41:41 +08:00
yazi-packing refactor: switch to actor model (#2986) 2025-07-14 23:08:11 +08:00
yazi-parser feat: port task manager to Lua (#3134) 2025-09-03 22:25:16 +08:00
yazi-plugin feat: progress of each task (#3121) 2025-09-04 18:55:28 +08:00
yazi-proxy feat: port task manager to Lua (#3134) 2025-09-03 22:25:16 +08:00
yazi-scheduler feat: port task manager to Lua (#3134) 2025-09-03 22:25:16 +08:00
yazi-shared feat: progress of each task (#3121) 2025-09-04 18:55:28 +08:00
yazi-term refactor: satisfy mismatched-lifetime-syntaxes lint (#2881) 2025-06-16 11:52:35 +08:00
yazi-watcher perf: zero-copy UrlBuf to Url conversion (#3117) 2025-08-28 23:06:04 +08:00
yazi-widgets fix: avoid appending a newline when reading clipboard contents (#3059) 2025-08-14 11:26:46 +08:00
.envrc refactor(nix): add shell completion and avoid impure (#293) 2023-10-22 08:10:53 +08:00
.gitignore ci: validate form 2025-02-21 20:07:34 +08:00
.luarc.json feat: make mimetype matching more robust (#3082) 2025-08-19 15:17:32 +08:00
Cargo.lock fix: Windows path length may exceed MAX_PATH (#3137) 2025-09-04 17:02:18 +08:00
Cargo.toml fix: Windows path length may exceed MAX_PATH (#3137) 2025-09-04 17:02:18 +08:00
CODE_OF_CONDUCT.md fix!: eliminate the x- prefix in mime-types (#1927) 2024-11-21 15:06:07 +08:00
CONTRIBUTING.md feat: make ui.Line renderable (#2743) 2025-05-10 11:50:06 +08:00
cspell.json feat: casefold (#3114) 2025-08-27 15:55:35 +08:00
flake.lock perf: zero-copy UrlBuf to Url conversion (#3117) 2025-08-28 23:06:04 +08:00
flake.nix fix(nix): rust overlay infinite recursion (#2216) 2025-01-18 18:10:51 +08:00
LICENSE fix: typo of LICENSE file (#201) 2023-09-21 23:11:51 +08:00
LICENSE-ICONS feat!: redesign icons (#1086) 2024-05-25 22:56:08 +08:00
README.md perf: zero-copy UrlBuf to Url conversion (#3117) 2025-08-28 23:06:04 +08:00
rustfmt.toml fix: warnings should be output to stderr instead of stdout (#1669) 2024-09-21 20:12:35 +08:00
stylua.toml feat: make mimetype matching more robust (#3082) 2025-08-19 15:17:32 +08:00


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

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 Inline images protocol Built-in
Black Box Sixel graphics format Built-in
Hyper Inline images protocol Built-in
Bobcat Inline images protocol Built-in
X11 / Wayland Window system protocol ☑️ Überzug++ required
Fallback ASCII 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.