espanso

Herramienta de sustitución de texto (text expansion)

Una herramienta de sustitución de texto (text expander) detecta cuándo escribes una palabra (o sucesión de caracteres) en concreto y la reemplaza por otra cosa.

Versión para Linux, Windows y macOS

Uso

Lanzamos el demonio:

espanso start

En Windows, en la versión portable, espanso se ejecuta a través del fichero START_ESPANSO.bat.

Podemos verificar que está funcionando con:

espanso status

Configuración

Linux: $HOME/.config/espanso
Windows: %APPDATA%\espanso

En la versión portable de Windows, la configuración se guarda en el directorio .espanso

En el fichero match/base.yml añadimos las reglas de sustitución:

matches:
  - trigger: ":saludo"
    replace: "Muy buenas, amigos,"

Cuando escribamos :saludo, espanso lo sustituirá automáticamente por Muy buenas, amigos,

Si queremos escribir varias líneas, lo más cómodo es usar la siguiente sintaxis:

  - trigger: ":lineas"
    replace: |
      Esto es una línea,
      y esta otra,
      y otra más

Si queremos que el cursor se coloque en una determinada posición tras la sustitución utilizaremos $|$ :

  - trigger: ":sql"
    replace: |
      SELECT $|$
      FROM

Al escribir :sql, espanso lo sustituirá por el texto indicado y colocará el cursor después de SELECT.

Instalación de paquetes

Podemos instalar fácilmente configuraciones creadas por otros usuarios y disponibles desde https://hub.espanso.org/.

Para instalar:

espanso install <NOMBRE_PAQUETE>

Y reinicamos espanso:

espanso restart

Por ejemplo, el paquete de emojis:

espanso install all-emojis
espanso restart

Deshabilitar temporalmente

Si queremos alternar entre la ejecución o pausa de espanso, pulsamos dos veces seguidas la tecla Alt. Veremos una notificación que nos indicará el estado de espanso.

Múltiples líneas

Si queremos hacer una sustitución por un texto que ocupa varias líneas:

- trigger: ":test"
    replace: |
      test
      multiline
      and
      another line

Matches (documentación oficial de espanso)

Search bar

Espanso incluye una barra de búsqueda para buscar rápidamente, e insertar, tus coincidencias (matches).

Para abrirla, hay dos formas:

Alt+Espacio
Pulsando en el icono de espanso, en la barra de tareas, y eligiendo Open search bar (no disponible en Linux)

Si queremos personalizar el atajo de teclado para abrirla, editaremos el fichero config/default.yml:

search_shortcut: ALT+SHIFT+SPACE

Listado de teclas soportadas