Add Handy speech-to-text documentation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Cal Corum 2026-02-17 10:11:58 -06:00
parent d656f1732e
commit beb1ccb376
2 changed files with 49 additions and 0 deletions

View File

@ -3,6 +3,11 @@
## Overview
ADHD-optimized task management system designed to break the context-switching spiral. The system uses a persistent terminal dashboard with zero-friction brain dump capture to help maintain focus while capturing interrupting thoughts.
## Handy - Speech to Text
Desktop speech-to-text app with system tray integration. Installed via RPM from GitHub.
- **Binary**: `/usr/bin/handy` | **Version**: 0.7.6
- **Docs**: [handy-speech-to-text.md](handy-speech-to-text.md)
## Architecture Patterns
### Single-Focus with Brain Dump Pattern

View File

@ -0,0 +1,44 @@
# 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