🎙️ Instalar o Handy mais recente no Debian

O que é o Handy?

Handy é um aplicativo de voz para texto gratuito e de código aberto que funciona totalmente offline. Ele espera em segundo plano com um ícone na bandeja; você aperta um atalho de teclado global, fala o que quer escrever, e o Handy transcreve na sua própria máquina e cola o texto na janela que estiver em foco: um editor, um terminal, um cliente de chat, um formulário no navegador. Nada é enviado para um serviço na nuvem. Os modelos de voz (o Whisper da OpenAI em vários tamanhos e o Parakeet da NVIDIA, rápido até numa CPU comum) são baixados uma vez de dentro do aplicativo e depois rodam localmente, com detecção de atividade de voz cortando o silêncio antes que o modelo o ouça. É um aplicativo Tauri escrito em Rust por CJ Pais, sob licença MIT, e funciona tanto em desktops X11 quanto Wayland.

⚡ Principais recursos do Handy

📦 Instalação a partir do deb.griffo.io

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt update

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update

sudo apt install extrepo
sudo extrepo enable griffo
sudo apt update

# Instalar a versão mais recente do Handy
sudo apt install handy

# Verificar a instalação
dpkg -s handy | grep Version

# Instalar a versão mais recente do Handy
apt install handy

# Verificar a instalação
dpkg -s handy | grep Version

# Abra o Handy pelo menu de aplicativos ou por um terminal
handy

# A primeira execução guia você na escolha de um modelo; ele é baixado
# uma vez, e daí em diante toda transcrição roda offline nesta máquina

# Os utilitários que digitam o texto (xdotool, wtype, wl-clipboard) vieram
# com o pacote. O GNOME no Wayland precisa do ydotool e do seu daemon;
# confira se ele está instalado (é recomendado, onde a versão o tem)
apt policy ydotool

🎯 Exemplos básicos de uso

Ditando:

# 1. Coloque o cursor onde o texto deve ir: um editor, um terminal, um chat
# 2. Aperte o atalho definido nas configurações do Handy e fale
# 3. Aperte de novo (ou solte, no modo aperte para falar)
# A transcrição é colada onde o cursor estava

# O Handy continua na bandeja; abra de novo se você o fechou
handy

Escolhendo o microfone:

# Listar os dispositivos de captura que o kernel enxerga
arecord -l

# Os nomes de entrada que o PipeWire ou o PulseAudio mostram nas configurações do Handy
pactl list short sources

# Conferir o nível da entrada padrão antes de culpar o modelo
arecord -d 5 /tmp/test.wav && aplay /tmp/test.wav

Mantendo em dia:

# O Handy é atualizado junto com o resto do sistema
sudo apt update && sudo apt upgrade

# Qual versão está instalada e qual é a mais recente disponível
apt policy handy

# Remover
sudo apt remove handy

# O Handy é atualizado junto com o resto do sistema
apt update && apt upgrade

# Qual versão está instalada e qual é a mais recente disponível
apt policy handy

# Remover
apt remove handy

🚀 Por que escolher o deb.griffo.io?

• ✅ A única fonte apt: o Handy não está nos arquivos do Debian nem nos do Ubuntu; este repositório empacota a versão oficial do upstream
• ✅ Um nome só: o pacote se chama handy e o comando também: sudo apt install handy e depois handy ou o atalho no menu
• ✅ Privado por construção: o pacote traz o aplicativo, não um modelo nem um serviço; sua voz nunca sai da máquina, e a rede só é usada para baixar o modelo escolhido
• ✅ Pacote completo: o build oficial do upstream para Linux (binário, bibliotecas embutidas, entrada de desktop, ícones) com as dependências declaradas para instalar em todas as versões suportadas, os utilitários de entrada de texto puxados junto, e só a categoria de menu vazia do lançador preenchida
• ✅ Atualizações automáticas: os pacotes são atualizados poucas horas após cada lançamento upstream
• ✅ Duas arquiteturas: amd64 no Bookworm, Trixie, Forky e Sid; arm64 só no Trixie, Forky e Sid, porque o upstream compila arm64 contra a glibc 2.39 e o Bookworm tem a 2.36; não há build para i386, armhf ou riscv64
• ✅ Multi-distribuição: funciona no Bookworm, Trixie, Forky e Sid
• ✅ Manutenção simples: atualizações com os comandos apt de sempre

📦 Repositório de build do pacote

Os pacotes Debian são construídos e mantidos automaticamente neste repositório do GitHub:

• 🎙️ handy-debian - Builds dos últimos lançamentos

🔗 Pacotes relacionados

Também disponíveis no deb.griffo.io:

• Zed - Um editor de código gráfico e rápido para ditar
• ZapZap - Um cliente de WhatsApp para desktop, para respostas que você prefere falar a digitar
• GPU Screen Recorder - Outra ferramenta de desktop para X11 e Wayland, para gravar a tela
• kitty - Um terminal com GPU onde mensagens de commit ditadas chegam do mesmo jeito
• Ghostty - Um terminal GTK nativo, a mesma história