Si alguna vez has ejecutado man para recordar una opción de un comando y has terminado leyendo tres pantallas de texto para encontrar el ejemplo que buscabas, tldr va a convertirse en tu nuevo mejor amigo en la terminal. En esta guía vemos qué es, cómo instalarlo en las principales distribuciones de Linux (y también en macOS y Windows), cómo configurarlo en español y qué ventajas ofrece frente al clásico man.
Qué es tldr
tldr es una colección comunitaria de páginas de ayuda concisas y orientadas a ejemplos prácticos para comandos de consola. En lugar de la documentación exhaustiva de man, cada página de tldr muestra directamente los casos de uso más habituales de un comando, listos para copiar y pegar. Es la diferencia entre leer un manual técnico y preguntarle a alguien con experiencia “oye, ¿cómo se usa esto normalmente?”.
Clientes oficiales: ¿cuál elijo?
El proyecto tldr-pages mantiene varios clientes oficiales, y elegir el adecuado depende de tu sistema y tus preferencias:
- Cliente en Python (recomendado): estable, con buen soporte de idiomas y fácil de mantener actualizado.
-
Cliente en Rust (
tlrc): rápido y moderno, buena opción si priorizas rendimiento. - Cliente en Node.js: el más veterano de los tres; sigue funcionando, aunque suele recibir actualizaciones con menos frecuencia.
- Web/PWA: tldr.inbrowser.app, útil si no quieres instalar nada y quieres poder usarla también sin conexión como aplicación web progresiva.
Instalación por plataforma
Linux
tldr está disponible en los repositorios de la mayoría de distribuciones, así que la instalación depende del gestor de paquetes que use la tuya. Estos son los comandos para las familias más comunes:
Debian, Ubuntu y derivadas (Linux Mint, Pop!_OS, elementary OS, MX Linux…):
# Cliente Python vía pipx (recomendado)
sudo apt install pipx
pipx install tldr
tldr --update
# Cliente Node.js
sudo apt install nodejs npm
sudo npm install -g tldr
Fedora / RHEL / derivadas:
sudo dnf install tldr
Arch Linux / Manjaro:
# Cliente Python, en los repositorios oficiales
sudo pacman -S tldr
# Cliente Rust (tlrc), desde el AUR con tu ayudante habitual (yay, paru...)
yay -S tlrc
openSUSE:
sudo zypper install tlrc
Independiente de la distribución (funciona en cualquiera con Python, Rust o Node instalados):
# Python vía pipx o pip
pipx install tldr
# Rust (tlrc)
cargo install tlrc --locked
# Node.js
npm install -g tldr
# Snap (disponible en la mayoría de distros)
sudo snap install tldr
Sin instalar nada: abre tldr.inbrowser.app y añádela como PWA desde el navegador para tener acceso offline.
En distribuciones basadas en Debian/Ubuntu (incluida Linux Mint), es preferible usar
pipxo el AUR/repositorio nativo detlrcen lugar de paquetes de terceros desactualizados. Comprueba siempre la versión disponible en tu gestor de paquetes conapt show tldr,dnf info tldr, etc.
macOS
# Con Homebrew + tlrc
brew install tlrc
tlrc --update
# Con pipx
brew install pipx
pipx install tldr
# Con Node.js
brew install node
npm install -g tldr
Windows
# Cliente Rust vía winget
winget install tldr-pages.tlrc
# Cliente Node.js
npm install -g tldr
También puedes recurrir a la web PWA en tldr.inbrowser.app si prefieres no instalar ningún paquete.
Soporte de idiomas: ¿hace falta traducir tldr o ya viene en español?
Una duda habitual: ¿es necesario recurrir a una traducción automática, o tldr ya soporta otros idiomas además del inglés?
La respuesta corta es que no necesitas traducir nada por tu cuenta: tldr-pages es un proyecto community-driven que mantiene traducciones oficiales en decenas de idiomas —español incluido— hechas por colaboradores del propio proyecto. Los clientes (Python, tlrc, Node.js) descargan directamente esa base de datos de páginas ya traducidas cuando ejecutas tldr --update, y la seleccionan automáticamente según el idioma de tu sistema. No hay que instalar un paquete de idioma aparte ni tocar la base de datos manualmente: se actualiza igual que las páginas en inglés.
Dicho esto, hay un matiz importante: la traducción al español, como la de cualquier otro idioma, es un trabajo en curso hecho por voluntarios, así que no todas las páginas están traducidas todavía. Cuando una página no tiene versión en español, el cliente hace fallback automático al inglés en lugar de mostrar un error. Es precisamente en esos huecos donde tiene sentido una traducción automática (como la que veremos con Translate Shell más abajo): no sustituye al soporte nativo de idiomas de tldr, sino que lo complementa para los comandos que aún no tienen traducción oficial.
Para comprobar el idioma de tu sistema:
echo $LANG
Para ver qué idioma está usando tldr:
tldr --language
Para forzar el español o el inglés en una sesión:
export TLDR_LANG=es # español
export TLDR_LANG=en # inglés
Si quieres que el cambio sea permanente, añade la línea correspondiente a tu ~/.bashrc o ~/.zshrc.
tldr frente a man: ¿cuándo uso cada uno?
tldr aporta:
- Resúmenes prácticos con ejemplos listos para copiar.
- Lectura rápida, ideal para refrescar opciones comunes.
- Soporte multilenguaje cuando existe traducción disponible.
- Actualización sencilla desde el repositorio central de tldr-pages.
man aporta:
- Referencia completa y detallada de cada comando.
- Cobertura exhaustiva de todas las opciones y comportamientos del sistema.
- Disponibilidad local, sin depender de descargas externas.
En la práctica, la regla es sencilla: usa tldr cuando necesites recordar rápido cómo se usa un comando, y recurre a man cuando necesites la documentación completa o algún detalle técnico concreto que tldr no cubra.
Comandos y trucos útiles
Actualizar las páginas:
tldr --update
# o, si usas tlrc
tlrc --update
Listar todas las páginas disponibles:
tldr ls
Mostrar la salida sin colores (útil si quieres procesarla o traducirla):
tldr ls | sed 's/\x1b\[[0-9;]*m//g'
Comprobar si ya tienes descargada una página traducida en concreto:
ls ~/.local/share/tldr/pages/es/common/ls.md
Traducción automática en la terminal (opcional)
Como se explicaba más arriba, esto no es necesario para usar tldr en español, sino un complemento para las páginas que todavía no tienen traducción oficial. Si quieres cubrir ese hueco con una traducción automática al vuelo, puedes combinar tldr con Translate Shell:
sudo apt install translate-shell
Añade esta función a tu ~/.bashrc o ~/.zshrc:
tldres() {
tldr "$@" | sed 's/\x1b\[[0-9;]*m//g' | trans -b en:es
}
Recarga la configuración y pruébala:
source ~/.bashrc
tldres ls
Solución de problemas comunes
“No tldr entry for ls”
tldr --update
Si el problema persiste, elimina la caché local y vuelve a actualizar:
rm -rf ~/.local/share/tldr
tldr --update
Si aun así no se soluciona, lo más sencillo es instalar un cliente moderno (Python o Rust) y repetir la actualización.
El comando tldr apunta a un binario antiguo
Comprueba qué binario se está ejecutando realmente para descartar conflictos de rutas:
which tldr
type tldr
Buenas prácticas
- En distribuciones basadas en Debian/Ubuntu, prioriza
pipxotlrcsi el paquete de tus repositorios oficiales está desactualizado. - Mantén las páginas actualizadas periódicamente con
tldr --update. - Usa la variable
TLDR_LANGsi trabajas habitualmente en varios idiomas. - Si no quieres instalar nada, la web PWA es una alternativa perfectamente válida.
Recursos oficiales
- Página oficial: tldr.sh
- Web/PWA: tldr.inbrowser.app
- Repositorio de páginas: tldr-pages en GitHub
Conclusión
tldr es una herramienta ligera y práctica que agiliza el trabajo diario en la terminal. Instalar un cliente moderno como el de Python o Rust te da acceso a páginas actualizadas y soporte de idiomas; y si prefieres no instalar nada, la web PWA cubre perfectamente esa necesidad. Y cuando necesites profundizar más allá de los ejemplos rápidos, man sigue ahí para lo que tldr no cubre.
