Hoja de Referencia de Yazi - Gestor de Archivos de Terminal Ultrarrápido

Hoja de Referencia de Yazi - Gestor de Archivos de Terminal Ultrarrápido

Un gestor de archivos de terminal ultrarrápido escrito en Rust, construido sobre E/S asíncrona. Incluye vistas previas de imágenes, operaciones masivas, atajos de teclado tipo Vim, un sistema de plugins en Lua e integraciones con ripgrep, fd, fzf y zoxide.

Instalación

Plataforma	Comando
macOS (Homebrew)	brew install yazi ffmpegthumbnailer poppler fd ripgrep fzf zoxide font-symbols-only-nerd-font
Arch Linux	sudo pacman -S yazi ffmpegthumbnailer poppler fd ripgrep fzf zoxide
Ubuntu/Debian	Descargar desde GitHub releases
Fedora/RHEL	sudo dnf install yazi
Windows (Scoop)	scoop install yazi
Windows (Winget)	winget install sxyazi.yazi
Cargo (Todas las plataformas)	cargo install --locked yazi-fm yazi-cli
Nix	nix-env -iA nixpkgs.yazi

Dependencias opcionales para características completas: ffmpegthumbnailer (miniaturas de video), poppler (vista previa de PDF), fd, ripgrep, fzf, zoxide, ImageMagick, 7-Zip/unar.

Lanzar: Ejecutar yazi o yazi /path/to/dir

Navegación

Tecla	Descripción
h	Ir al directorio padre
l o Enter	Abrir archivo o entrar al directorio
j	Mover cursor hacia abajo
k	Mover cursor hacia arriba
J	Mover cursor 5 líneas hacia abajo
K	Mover cursor 5 líneas hacia arriba
g g	Saltar al primer elemento
G	Saltar al último elemento
H	Retroceder en historial
L	Avanzar en historial
~	Ir al directorio home
Backspace	Ir al directorio padre
z	Saltar vía zoxide (búsqueda difusa de directorio)
Z	Saltar vía fzf

Operaciones con Archivos

Tecla	Descripción
o	Abrir archivo seleccionado con programa predeterminado
O	Abrir archivo interactivamente (elegir programa)
y	Copiar (yank) archivos seleccionados
x	Cortar archivos seleccionados
p	Pegar archivos copiados/cortados
P	Pegar con sobrescritura
d	Enviar archivos seleccionados a papelera
D	Eliminar permanentemente archivos seleccionados
a	Crear un nuevo archivo o directorio (agregar / para directorio)
r	Renombrar archivo seleccionado
c	Renombrar con cursor al inicio
.	Alternar mostrar archivos ocultos

Selección

Tecla	Descripción
Space	Alternar selección en elemento actual
v	Entrar en modo visual (seleccionar rango)
V	Entrar en modo visual (deseleccionar rango)
Ctrl+a	Seleccionar todos los elementos
Ctrl+r	Selección inversa (alternar todos)
Esc	Cancelar selección / salir de modo visual

Búsqueda y Filtrado

Tecla	Descripción
/	Buscar en directorio actual
?	Buscar hacia atrás
n	Saltar a siguiente coincidencia de búsqueda
N	Saltar a coincidencia anterior de búsqueda
f	Filtrar directorio actual (mostrar solo coincidentes)
s	Buscar archivos con fd en subdirectorios
S	Buscar contenido de archivos con ripgrep

Ordenación

Tecla	Descripción
,m	Ordenar por tiempo de modificación
,M	Ordenar por tiempo de modificación (inverso)
,c	Ordenar por tiempo de creación
,C	Ordenar por tiempo de creación (inverso)
,e	Ordenar por extensión
,E	Ordenar por extensión (inverso)
,a	Ordenar alfabéticamente
,A	Ordenar alfabéticamente (inverso)
,n	Ordenar naturalmente (consciente de números)
,N	Ordenar naturalmente (inverso)
,s	Ordenar por tamaño
,S	Ordenar por tamaño (inverso)
,r	Ordenar aleatoriamente

Pestañas

Tecla	Descripción
t	Crear nueva pestaña
1-9	Cambiar a pestaña por número
[	Cambiar a pestaña anterior
]	Cambiar a siguiente pestaña
{	Intercambiar pestaña con anterior
}	Intercambiar pestaña con siguiente

Operaciones Masivas

Tecla	Descripción
Space (en múltiples)	Seleccionar múltiples archivos, luego usar y/x/d
r	Renombrar (usar en selección para renombrado masivo)

Flujo de Trabajo de Renombrado Masivo

1. Seleccionar archivos con Space o modo visual (v)
2. Presionar r para abrir renombrado masivo en tu $EDITOR
3. Editar nombres de archivo en el editor
4. Guardar y cerrar — Yazi aplica todos los renombrados

Sistema de Vista Previa

Yazi proporciona vistas previas integradas para muchos tipos de archivo:

Tipo de Archivo	Vista Previa
Imágenes (PNG, JPG, etc.)	Vista previa de imagen en línea (en terminales compatibles)
Videos	Vista previa de miniatura (requiere ffmpegthumbnailer)
PDFs	Vista previa de primera página (requiere poppler)
Texto/Código	Vista previa con resaltado de sintaxis
Archivos	Listado de contenido
Directorios	Listado de archivos hijos

Terminales compatibles para vista previa de imágenes: Kitty, iTerm2, WezTerm, Ghostty, foot, Konsole, Windows Terminal, VSCode, Warp.

Configuración

Ubicaciones de Archivos de Configuración

Archivo	Propósito
~/.config/yazi/yazi.toml	Configuración general
~/.config/yazi/keymap.toml	Atajos de teclado personalizados
~/.config/yazi/theme.toml	Colores y estilos
~/.config/yazi/init.lua	Inicialización de plugins

Configuración Clave (yazi.toml)

[manager]
show_hidden = false          # Show dotfiles by default
sort_by = "natural"          # natural, alphabetical, size, modified, created, extension
sort_dir_first = true        # Directories before files
linemode = "size"            # Info shown next to filename: size, mtime, permissions, none

[preview]
max_width = 1000             # Max preview width
max_height = 1000            # Max preview height
image_quality = 75           # JPEG quality for thumbnails

[opener]
# Custom file openers
edit = [{ run = 'nvim "$@"', block = true }]
open = [{ run = 'open "$@"' }]  # macOS: open, Linux: xdg-open

Integración con Shell

Cambiar directorio al salir (recomendado)

Agregar a tu configuración de shell para que al salir de Yazi te ubiques en el último directorio que visitaste:

Bash/Zsh:

function y() {
  local tmp="$(mktemp -t "yazi-cwd.XXXXXX")" cwd
  yazi "$@" --cwd-file="$tmp"
  if cwd="$(command cat -- "$tmp")" && [ -n "$cwd" ] && [ "$cwd" != "$PWD" ]; then
    builtin cd -- "$cwd"
  fi
  rm -f -- "$tmp"
}

Fish:

function y
  set tmp (mktemp -t "yazi-cwd.XXXXXX")
  yazi $argv --cwd-file="$tmp"
  if set cwd (command cat -- $tmp); and [ -n "$cwd" ]; and [ "$cwd" != "$PWD" ]
    builtin cd -- "$cwd"
  end
  rm -f -- $tmp
end

Sistema de Plugins

# Install a plugin
ya pack -a owner/plugin-name

# Update all plugins
ya pack -u

# List installed plugins
ya pack -l

Plugins populares: integración de estado de git, extracción de archivos, manipulación de imágenes, previsualizadores personalizados.

Flujos de Trabajo Comunes

# Launch in a specific directory
yazi ~/projects

# Quick file browsing with image previews
yazi ~/photos

# Bulk rename workflow
# 1. Navigate to directory
# 2. Select files with Space or v
# 3. Press r to bulk rename in editor

Comparación con Otros Gestores de Archivos

Característica	Yazi	ranger	lf	nnn
Lenguaje	Rust	Python	Go	C
E/S asíncrona	Sí	No	No	No
Vista previa de imágenes	Nativo	Sí	Plugin	Plugin
Sistema de plugins	Lua	Python	Shell	Shell
Velocidad	Muy rápido	Moderado	Rápido	Muy rápido
Renombrado masivo	Integrado	Integrado	Externo	Externo
Atajos de Vim	Sí	Sí	Sí	No

Recursos

• Official Website
• Documentation
• GitHub Repository
• Plugin Directory