---
title: "Handy Speech-to-Text Setup"
description: "Installation and usage guide for Handy, a desktop speech-to-text app with system tray integration. Covers RPM install on Nobara/Fedora, CLI flags, and Wayland/GTK dependencies."
type: guide
domain: productivity
tags: [handy, speech-to-text, wayland, gtk, nobara, fedora, rpm]
---

# Handy - Speech to Text

## Overview
Desktop speech-to-text application with system tray integration. Records audio and transcribes to text, with optional post-processing.

- **GitHub**: https://github.com/Handy-caT/handy
- **License**: MIT

## Installation

### This Machine (Nobara / Fedora-based)
Installed from GitHub release RPM:

```bash
# Download Handy-0.7.6-1.x86_64.rpm from GitHub releases
sudo dnf install /path/to/Handy-0.7.6-1.x86_64.rpm
```

**Required dependency** (not bundled):
```bash
sudo dnf install gtk-layer-shell
```

### Installed Files
- **Binary**: `/usr/bin/handy`
- **Resources**: `/usr/lib/Handy/resources/`
- **Desktop entry**: `/usr/share/applications/Handy.desktop`
- **Version installed**: 0.7.6

## Usage

```bash
handy                          # Launch with GUI
handy --start-hidden           # Start minimized to tray
handy --toggle-transcription   # Toggle recording (sent to running instance)
handy --toggle-post-process    # Toggle with post-processing
handy --cancel                 # Cancel current operation
handy --no-tray                # Launch without system tray icon
```

## Notes
- Uses Silero VAD (Voice Activity Detection) model for speech detection
- Runs as a Wayland-native GTK app (uses gtk-layer-shell)
- System tray icon shows idle/recording/transcribing states