Dicta en cualquier parte. Abre una terminal con una tecla.

Qué hace

Atajos

Cuatro teclas, la misma idea en los dos sistemas. Todas se pueden cambiar.

En Windows, Win+Espacio y Ctrl+Win+Espacio son del selector de método de entrada de Windows y no se pueden registrar; por eso las teclas de la terminal usan Ctrl+Shift. Si otro programa ya usa una combinación (un método de entrada suele tomar Ctrl+Espacio), Settings → Shortcuts dice que Windows la rechazó: cambia la tecla en %APPDATA%\whisper-terminal\settings.toml y presiona «Rebind shortcuts».

En Linux, GNOME las registra solo; en otros escritorios algunas no pueden, y ~/.local/bin/whisper-terminal --doctor dice cuáles y cómo asignarlas a mano.

Antes de descargar

Descargar

Instalar

Elige tu sistema. Los dos se instalan en tu carpeta de usuario, sin permisos de administrador; solo las bibliotecas del paso 2 de Linux piden sudo.

Windows · Linux

Windows

El instalador es por usuario: sin permisos de administrador y sin tocar nada fuera de tus carpetas. El zip portátil, más abajo, es el mismo programa sin instalador.

Primera vista previa que nunca se ha ejecutado en una PC real: estos pasos dicen lo que está hecha para hacer. Dinos dónde no coincide.

1. Revisa la descarga. En PowerShell, en la carpeta donde la guardaste (normalmente Descargas: cd $HOME\Downloads te lleva ahí):

$expected = "b890c69fcf991409ee90ec908596cc56bb6985548dd8cfd0b8b9e3fe8439fae4"
(Get-FileHash .\WhisperTerminal-0.1.0-windows-x86_64-setup.exe -Algorithm SHA256).Hash -eq $expected

Debe imprimir True. Si imprime False, no la ejecutes: descárgala otra vez.

2. Opcional pero recomendable: instala Git para Windows para que las terminales abran Git Bash. Sin él abren PowerShell.

3. Ejecuta el instalador.

Haz doble clic. Windows probablemente dirá «Windows protegió su PC» (SmartScreen) porque el programa todavía no está firmado: elige «Más información» y luego «Ejecutar de todas formas» (More info, Run anyway). El instalador te pide una carpeta (en una primera instalación propone %LOCALAPPDATA%\Programs\WhisperTerminal) y en la última página ofrece iniciar Whisper Terminal ahora (marcado) e iniciarlo cuando inicies sesión en Windows (sin marcar).

4. Arráncala y mira qué hace.

Desde la última página del instalador o desde Whisper Terminal en el menú Inicio. Aparece un icono pequeño en el área de notificación (haz clic en ^ si Windows lo oculta) y las terminales se abren una vez: eso es lo que hace arrancarla (cuando arranca al iniciar sesión lo hace en silencio, solo con el icono). Clic derecho en el icono abre el menú (Start dictation, Terminals, History, Settings, Quit). Luego presiona Ctrl+Espacio en cualquier programa, habla y presiónala otra vez: el primer dictado empieza a descargar un modelo de voz (una línea de progreso aparece en Settings), así que dicta de nuevo cuando termine.

Zip portátil en lugar del instalador

Revísalo igual que en el paso 1, con el nombre del zip y su SHA-256 de la tarjeta de arriba:

$expected = "c86b90eeb6fbe8f4e4398a454ee570f92a299ad7df8c26c12840a40f71817eb3"
(Get-FileHash .\WhisperTerminal-0.1.0-windows-x86_64.zip -Algorithm SHA256).Hash -eq $expected

Luego descomprímelo en una carpeta tuya (clic derecho, «Extraer todo») y haz doble clic en whisper-terminal.exe dentro de la carpeta, o en PowerShell:

Expand-Archive .\WhisperTerminal-0.1.0-windows-x86_64.zip -DestinationPath $HOME
Start-Process "$HOME\WhisperTerminal-0.1.0-windows-x86_64\whisper-terminal.exe"

SmartScreen puede aparecer también aquí, en el primer arranque. Para que arranque con tu sesión, activa «Start at login» en Settings → System.

Quitarla

Si la instalaste con el instalador: Configuración → Aplicaciones → Aplicaciones instaladas (en Windows 10: Aplicaciones y características) → Whisper Terminal → Desinstalar (o ejecuta uninstall.exe en la carpeta de instalación). Cierra el programa, borra sus archivos, la entrada del menú Inicio y el valor de inicio con la sesión, y pregunta si también borra tus ajustes, tu historial y los modelos descargados (la respuesta predeterminada es No).

Si usaste el zip: clic derecho en el icono de la bandeja y Quit; si activaste «Start at login» (Settings → System), apágalo antes; y borra la carpeta.

Tus ajustes (%APPDATA%\whisper-terminal), tu historial, grabaciones, modelos y registros (%LOCALAPPDATA%\whisper-terminal) se quedan hasta que los borres tú. Para borrarlos, con la app cerrada:

Remove-Item -Recurse "$env:APPDATA\whisper-terminal", "$env:LOCALAPPDATA\whisper-terminal"

Si algo no funciona

Guarda cómo ve este equipo el programa, en la carpeta que tiene whisper-terminal.exe (la de instalación, %LOCALAPPDATA%\Programs\WhisperTerminal si no elegiste otra, o la del zip descomprimido; --doctor no arranca la app):

.\whisper-terminal.exe --doctor | Out-File doctor.txt

Manda doctor.txt y el registro (%LOCALAPPDATA%\whisper-terminal\whisper-terminal.log, y wt-stt.log a su lado, del motor de voz) a support@vibedout.app, con lo que presionaste y lo que esperabas. Si un atajo dice que Windows lo rechazó, dinos qué tecla. whisper-terminal.exe --status y whisper-terminal.exe --stt probe también ayudan.

Linux

Siete pasos, y solo el segundo pide sudo. Todo lo demás se queda en tu carpeta de usuario.

1. Comprueba tu glibc: la primera línea debe terminar en 2.43 o más.

ldd --version | head -1

Si es menor, el programa no arranca (dice version GLIBC_2.43 not found) y no tiene caso seguir.

2. Instala las bibliotecas que usa. En Debian, Ubuntu y derivadas:

sudo apt install libxkbcommon-x11-0 libvulkan1 mesa-vulkan-drivers alsa-utils

En Fedora:

sudo dnf install libxkbcommon-x11 vulkan-loader mesa-vulkan-drivers alsa-utils

En GNOME, el icono de la bandeja necesita la extensión AppIndicator (Ubuntu la trae activa; en Fedora se instala aparte). Sin ella la app funciona, pero sin icono.

3. Verifica, extrae y enlaza el comando, en la carpeta donde descargaste el archivo (normalmente ~/Descargas o ~/Downloads):

echo "3fb6e1dfbf3686ec4e5fe30c4ac187475e1d5b417085bd32fce20450647c78f8  whisper-terminal-linux-x86_64.tar.gz" | sha256sum -c - \
  && mkdir -p ~/.local/opt ~/.local/bin \
  && tar -xzf whisper-terminal-linux-x86_64.tar.gz -C ~/.local/opt \
  && ln -sf ~/.local/opt/whisper-terminal/bin/whisper-terminal ~/.local/bin/whisper-terminal

El primer comando debe decir «OK». Si dice «FAILED», no extraigas nada: descarga otra vez. Si ya la tenías instalada, ciérrala antes con ~/.local/bin/whisper-terminal --quit. Si mueves la carpeta después, repite la última línea del paso 3 (y el paso 7) y luego el paso 6.

4. Un lanzador en la lista de aplicaciones (en bash o zsh):

mkdir -p ~/.local/share/applications
cat > ~/.local/share/applications/app.vibedout.WhisperTerminal.desktop <<EOF
[Desktop Entry]
Type=Application
Version=1.0
Name=Whisper Terminal
Comment=Dictate anywhere and open overlay terminals
Exec="$HOME/.local/bin/whisper-terminal"
Icon=utilities-terminal
Terminal=false
Categories=Utility;
Keywords=dictation;voice;speech;whisper;terminal;overlay;
StartupWMClass=app.vibedout.WhisperTerminal
StartupNotify=false
X-GNOME-UsesNotifications=true
EOF

Este sí aparece en la lista. El paquete no trae uno, por eso se escribe aquí.

5. Mira qué funciona en tu equipo:

~/.local/bin/whisper-terminal --doctor

--doctor no arranca la app: marca con FAIL lo que falta (teclas, bandeja, modelo) y dice cómo arreglarlo. En una instalación nueva es normal ver FAIL en «autostart» (todavía no lo activas), «dictation model» (el modelo recomendado se descarga en el primer dictado), «claude» (si no tienes Claude Code) y «skills» (se enlazan al primer arranque). Las teclas de fábrica están en la tabla de Atajos, arriba.

6. Arráncala ahora, en la bandeja y sin ventana, y haz que arranque con tu sesión:

setsid -f ~/.local/bin/whisper-terminal --background
~/.local/bin/whisper-terminal --autostart on

El segundo comando crea una entrada de inicio automático que no se muestra en la lista de aplicaciones (es adrede: es otro archivo, distinto del lanzador del paso 4). Se quita con ~/.local/bin/whisper-terminal --autostart off.

7. Opcional: usar el modelo que viene en el paquete, sin descargar nada (solo inglés):

mkdir -p ~/.local/share/whisper-terminal/models
ln -s ~/.local/opt/whisper-terminal/share/whisper-terminal/models/ggml-base.en.bin ~/.local/share/whisper-terminal/models/ggml-base.en.bin

Luego elígelo en Settings → Speech. Si ya habías descargado ese modelo, el comando lo deja como está.

Quitarla

~/.local/bin/whisper-terminal --quit
~/.local/bin/whisper-terminal --autostart off
~/.local/bin/whisper-terminal --shortcuts remove
~/.local/bin/whisper-terminal --skills unlink
[ -L ~/.local/share/whisper-terminal/models/ggml-base.en.bin ] && rm ~/.local/share/whisper-terminal/models/ggml-base.en.bin
rm -f ~/.local/bin/whisper-terminal ~/.local/share/applications/app.vibedout.WhisperTerminal.desktop
rm -rf ~/.local/opt/whisper-terminal

Esto la detiene, quita sus atajos de GNOME y los enlaces de skills, y borra el programa. Tus ajustes (~/.config/whisper-terminal), tu historial y modelos descargados (~/.local/share/whisper-terminal) y su registro (~/.local/state/whisper-terminal) se quedan hasta que los borres tú.