sxyazi/yazi
1
1
Fork 0
mirror of https://github.com/sxyazi/yazi.git synced 2024-12-01 10:17:47 +03:00
Code Issues Packages Projects Releases Wiki Activity
💥 Blazing fast terminal file manager written in Rust, based on async I/O.
391 Commits 2 Branches 18 Tags 43 MiB
Rust 92.7%
Lua 6.3%
Nix 0.8%
Shell 0.2%
6145bc38dc
Go to file
三咲雅 · Misaki Masa 6145bc38dc
fix: can't open and reveal paths with spaces on Windows (#526)
2024-01-17 00:13:23 +08:00
.github refactor: use as_encoded_bytes instead of as_bytes 2023-11-25 12:38:54 +08:00
nix fix: build with rust-overlay (#410) 2023-11-29 21:45:47 +08:00
scripts fix: can't clear screen and restore cursor when exit on Windows (#525) 2024-01-17 00:12:57 +08:00
yazi-adaptor chore: update trash to 3.2.1 2024-01-16 08:29:26 +08:00
yazi-config fix: can't open and reveal paths with spaces on Windows (#526) 2024-01-17 00:13:23 +08:00
yazi-core chore: update trash to 3.2.1 2024-01-16 08:29:26 +08:00
yazi-fm chore: update trash to 3.2.1 2024-01-16 08:29:26 +08:00
yazi-plugin fix: can't open and reveal paths with spaces on Windows (#526) 2024-01-17 00:13:23 +08:00
yazi-scheduler chore: update trash to 3.2.1 2024-01-16 08:29:26 +08:00
yazi-shared fix: can't clear screen and restore cursor when exit on Windows (#525) 2024-01-17 00:12:57 +08:00
.envrc refactor(nix): add shell completion and avoid impure (#293) 2023-10-22 08:10:53 +08:00
.gitignore chore: ignore configuration of editor (#322) 2023-10-26 23:02:37 +08:00
Cargo.lock chore: update trash to 3.2.1 2024-01-16 08:29:26 +08:00
Cargo.toml feat: add more optimization options (#377) 2023-11-18 11:44:43 +08:00
cspell.json feat: support display images in Ghostty 2024-01-06 11:11:08 +08:00
flake.lock fix: catchup with the latest stable Rust (#409) 2023-11-29 20:37:10 +08:00
flake.nix fix: catchup with the latest stable Rust (#409) 2023-11-29 20:37:10 +08:00
LICENSE fix: typo of LICENSE file (#201) 2023-09-21 23:11:51 +08:00
README.md feat: support display images in Ghostty 2024-01-06 11:11:08 +08:00
rustfmt.toml chore: add rustfmt.toml 2023-08-08 21:02:56 +08:00

README.md

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++, 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 (coming soon), custom previewer, and custom preloader; Just some pieces of Lua.
  • 🧰 Integration with fd, rg, fzf, zoxide
  • 💫 Vim-like input/select component, auto-completion for cd paths
  • 🏷️ Multi-Tab Support, Scrollable Preview (for videos, PDFs, archives, directories, code, etc.)
  • 🔄 Batch Renaming, Visual Mode, File Chooser
  • 🎨 Theme System, Custom Layouts, Trash Bin, CSI u
  • ... and more!

https://github.com/sxyazi/yazi/assets/17523360/92ff23fa-0cd5-4f04-b387-894c12265cc7

⚠️ Note: Yazi is currently in heavy development and may be unstable. The API is subject to change without prior notice.

Documentation

Discussion

Image Preview

Platform Protocol Support
kitty Kitty unicode placeholders ✅ Built-in
Konsole Kitty old protocol ✅ Built-in
iTerm2 Inline images protocol ✅ Built-in
WezTerm Inline images protocol ✅ Built-in
Mintty (Git Bash) Inline images protocol ✅ Built-in
foot Sixel graphics format ✅ Built-in
Ghostty Kitty old protocol ✅ Built-in
Black Box Sixel graphics format ✅ Built-in
Hyper Sixel graphics format ✅ Built-in
X11 / Wayland Window system protocol ☑️ Überzug++ required
Fallback Chafa ☑️ Überzug++ required

Yazi automatically selects the appropriate preview method for you, based on the priority from top to bottom. That's relying on the $TERM, $TERM_PROGRAM, and $XDG_SESSION_TYPE variables, make sure you don't overwrite them by mistake!

For instance, if your terminal is Alacritty, which doesn't support displaying images itself, but you are running on an X11/Wayland environment, it will automatically use the "Window system protocol" to display images -- this requires you to have Überzug++ installed.

Here is a guide for tmux users: Image preview within tmux

TODO

See Feature requests for more details.

License

Yazi is MIT licensed. For more information check the LICENSE file.