Handy

https://handy.computer/docs
Admin
Handy is a free and open-source desktop application that provides local, private speech-to-text...
Tokens:12,237
Snippets:178
Trust Score:9.3
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install Handy via Homebrew

Source: https://handy.computer/docs/getting-started

Install Handy using the community-maintained Homebrew cask. Run this command in the terminal after downloading the app or as an alternative to manual installation.

```bash
brew install --cask handy
```

--------------------------------

### Set WEBKIT_DISABLE_DMABUF_RENDERER=1 to fix blank window on Linux

Source: https://handy.computer/docs/troubleshooting

Run Handy with the environment variable WEBKIT_DISABLE_DMABUF_RENDERER=1 to work around a WebKit DMA-BUF rendering issue that causes a blank window on some Linux systems. Recent Handy versions set this automatically; older versions require manual setup.

```bash
WEBKIT_DISABLE_DMABUF_RENDERER=1 handy
```

--------------------------------

### Handy CLI usage syntax

Source: https://handy.computer/docs/cli

Shows the general command-line syntax for launching Handy with options. Useful for scripting and automation.

```bash
handy [OPTIONS]
```

--------------------------------

### sway/i3 keybinding for Handy

Source: https://handy.computer/docs/cli

Bind a key combination in sway or i3 to control Handy using signals or CLI flags. Signals are recommended.

```conf
# Using signals (recommended)
bindsym $mod+Shift+period exec pkill -USR2 -x handy

# Using CLI flags
bindsym $mod+Shift+period exec handy --toggle-transcription
```

--------------------------------

### Hyprland keybinding for Handy

Source: https://handy.computer/docs/cli

Bind a key combination in Hyprland to control Handy using signals or CLI flags. Signals are recommended.

```conf
# Using signals (recommended)
bind = $mainMod SHIFT, period, exec, pkill -USR2 -x handy

# Using CLI flags
bind = $mainMod SHIFT, period, exec, handy --toggle-transcription
```

--------------------------------

### Enable Debug Mode via CLI

Source: https://handy.computer/docs/debug

Use the command line to launch Handy with debug mode enabled on Linux.

```bash
handy --debug
```

--------------------------------

### Control Handy with Unix signals

Source: https://handy.computer/docs/cli

Use pkill with SIGUSR2 to toggle transcription and SIGUSR1 to toggle transcription with post-processing. Recommended for Wayland where global shortcuts often don't work natively.

```bash
# Toggle transcription
pkill -USR2 -x handy

# Toggle transcription with post-processing
pkill -USR1 -x handy
```

--------------------------------

### Convert to bullet points prompt

Source: https://handy.computer/docs/post-processing

Prompt template that instructs the AI to convert the transcription into concise bullet points. Uses the ${output} variable.

```text
Convert the following text into concise bullet points: ${output}
```

--------------------------------

### Identify Secure Input process on macOS

Source: https://handy.computer/docs/troubleshooting

Run this command in the terminal to find the process ID and name of the application currently holding Secure Input on macOS.

```bash
ioreg -l -w 0 | grep -o 'kCGSSessionSecureInputPID"=[0-9]*' | grep -o '[0-9]*' | head -1 | xargs ps -o pid,comm -p
```

--------------------------------

### Convert spoken punctuation to symbols prompt

Source: https://handy.computer/docs/post-processing

Prompt template that instructs the AI to convert spoken punctuation words to their symbols (e.g., 'period' to '.', 'comma' to ',', 'new line' to a line break) without changing anything else. Uses the ${output} variable.

```text
Convert spoken punctuation words to their symbols (e.g., "period" to ".",
"comma" to ",", "new line" to a line break). Don't change anything else: ${output}
```

--------------------------------

### Translate to Spanish prompt

Source: https://handy.computer/docs/post-processing

Prompt template that instructs the AI to translate English text to Spanish. Uses the ${output} variable.

```text
Translate the following English text to Spanish: ${output}
```

--------------------------------

### Fix grammar and punctuation prompt

Source: https://handy.computer/docs/post-processing

Prompt template that instructs the AI to fix grammar or punctuation errors while preserving meaning and tone. Uses the ${output} variable to reference the transcription.

```text
Fix any grammar or punctuation errors in the following text,
but don't change the meaning or tone: ${output}
```
Tokens:
Raw