Espanso es una de esas herramientas pequeñas que, cuando encajan en tu forma de trabajar, te roban minutos al reloj cada día y luego no los devuelven nunca. Y eso es bueno.

Dicho sin épica innecesaria: Espanso es un expansor de texto a nivel de sistema.

Escribes algo corto… y se transforma automáticamente en algo largo.

Es el autocomplete de tu cerebro.

Instalación en Ubuntu

Antes de empezar. Espanso funciona de forma fiable en X11, no en Wayland.
En Ubuntu moderno eso importa.

Comprobar si estás en X11 o Wayland

Abre una terminal y ejecuta:

echo $XDG_SESSION_TYPE

• x11 → perfecto, continúa
• wayland → recomendado cambiar a X11

Cambiar a X11 (GNOME)

1. Cierra sesión
2. En la pantalla de login, pulsa ⚙️
3. Elige “Ubuntu on Xorg”
4. Inicia sesión
5. Comprueba otra vez con echo $XDG_SESSION_TYPE

Descargar Espanso (versión X11)

Ve a la web oficial: https://espanso.org/docs/install/linux/#deb-x11

Descarga el paquete:

• espanso-debian-x11-amd64.deb

Opción recomendada: dpkg

Evita problemas de permisos con _apt.

sudo dpkg -i espanso-debian-x11-amd64.deb

Si salen errores de dependencias:

sudo apt -f install

Espanso usa systemd de usuario.
Si no lo registras, no arrancará solo.

espanso service register

Introduce tu contraseña si la pide.

---

Arrancar Espanso

espanso start

Comprobar estado:

espanso status

Resultado esperado:

espanso is running

---

Probar que funciona

Abre cualquier sitio donde puedas escribir:

• Terminal
• VS Code
• Navegador
• Editor de texto

Escribe:

:date

Si se sustituye por la fecha → funciona.

---

Dónde se configura Espanso

Ruta principal:

~/.config/espanso/

Atajos (lo importante):

~/.config/espanso/match/

Ejemplo de atajo simple:

matches:
  - trigger: ":hola"
    replace: "Hola mundo 👋"

Después de editar:

espanso restart

---

Arranque automático (comprobación)

Espanso debería arrancar solo al iniciar sesión.
Puedes verificarlo con:

systemctl --user status espanso

Posibles problemas

Problema	Causa habitual	Solución
❌ espanso is not running	El servicio no está registrado	Ejecutar:~~~bashespanso service registerespanso start~~~
❌ No expande texto	Estás en Wayland o Espanso no está activo	• Comprobar sesión X11:~~~bashecho $XDG_SESSION_TYPE~~~• Probar en un editor gráfico (VS Code, navegador, etc.)• Reiniciar Espanso:~~~bashespanso restart~~~
❌ Error al instalar Espanso X11 teniendo Wayland	Conflicto entre paquetes espanso-wayland y espanso-x11	Desinstalar primero Wayland:~~~bashsudo apt remove espanso-wayland~~~Luego instalar la versión X11

​Crear atajos en Espanso

En Ubuntu los atajos de Espanso se guardan en ~/.config/espanso/match y se editan en archivos YAML como base.yml.

Localizar la carpeta de Espanso en Ubuntu

• Ruta por defecto (si no tocaste XDG): ~/.config/espanso (es decir, /home/tu_usuario/.config/espanso).

​

También puedes verlo ejecutando:

espanso path

que te mostrará la ruta exacta de configuración en tu sistema.​

• ​

Entra en la carpeta de matches:

cd ~/.config/espanso/match

Abre (o crea) base.yml con tu editor favorito, por ejemplo:

nano base.yml

Asegúrate de que al menos tenga esta estructura básica:

matches:     
   - trigger: ":hola"      replace: "Hola, ¿qué tal?"

• matches: es la clave raíz y cada - define un atajo.
• trigger es lo que escribes y replace lo que Espanso inserta.

Ejemplos pensados para Ubuntu

Puedes añadir estos ejemplos bajo matches: en el mismo base.yml:

matches:
  # Saludo rápido
  - trigger: ":saludo"
    replace: "Hola, ¿qué tal estás?"

  # Comando típico de actualización
  - trigger: ":aptup"
    replace: "sudo apt update && sudo apt upgrade -y"

  # Firma para correos
  - trigger: ":firma"
    replace: "Un saludo,\nTu Nombre"

  # Fecha actual (útil para documentación)
  - trigger: ":hoy"
    replace: "{{hoy}}"
    vars:
      - name: hoy
        type: date
        params:
          format: "%Y-%m-%d"

• Estos snippets funcionan en cualquier app donde Espanso esté activo (terminal, editor, navegador, etc.).

​

La variable date permite generar la fecha en el formato indicado.

Recargar Espanso para aplicar cambios

• Después de guardar base.yml, recarga Espanso:

espanso restart

Si lo tienes como servicio de usuario (systemd), puede ser algo como:

systemctl --user restart espanso

según cómo lo instalases en Ubuntu.

​