cjpais/Handy

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/cjpais/Handy.svg?style=card)](https://bestofgithub.dev/repo/cjpais/Handy)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/cjpais/Handy.svg)](https://bestofgithub.dev/repo/cjpais/Handy)

Loading README…

Display Server	Recommended Tool	Install Command
X11	`xdotool`	`sudo apt install xdotool`
Wayland	`wtype`	`sudo apt install wtype`
Both	`dotool`	`sudo apt install dotool` (requires `input` group)

Distro	Package to install	Example command
Ubuntu/Debian	`libgtk-layer-shell0`	`sudo apt install libgtk-layer-shell0`
Fedora/RHEL	`gtk-layer-shell`	`sudo dnf install gtk-layer-shell`
Arch Linux	`gtk-layer-shell`	`sudo pacman -S gtk-layer-shell`

Action	Trigger
Toggle transcription	`pkill -USR2 -n handy` or `handy --toggle-transcription`
Toggle transcription with post-processing	`handy --toggle-post-process`

Distro	Package to install	Example command
Ubuntu/Debian	`libgtk-layer-shell0`	`sudo apt install libgtk-layer-shell0`
Fedora/RHEL	`gtk-layer-shell`	`sudo dnf install gtk-layer-shell`
Arch Linux	`gtk-layer-shell`	`sudo pacman -S gtk-layer-shell`

cjpais/Handy

Handy

Why Handy?

How It Works

Quick Start

Installation

Development Setup

Sponsors

Integrations

Debug Mode

CLI Parameters

Known Issues & Current Limitations

Bluetooth Headset Microphones (macOS)

fn and Globe Key Shortcuts (macOS)

Linux Notes

Verify Release Signatures

Troubleshooting

Previous Clipboard Content Is Pasted Instead of the Transcription

Manual Model Installation (For Proxy Users or Network Restrictions)

Step 1: Find Your App Data Directory

Step 2: Create Models Directory

Step 3: Download Model Files

Step 4: Install Models

Step 5: Verify Installation

Custom Whisper Models

Linux Startup Crashes or Instability

Empty recording overlay on Hyprland / Omarchy

Vulkan Overlays and Capture Tools on Windows (`HANDY_KEEP_VULKAN_IMPLICIT_LAYERS`)

How to Contribute

Related Projects

License

Acknowledgments