https://github.com/jpzk/wl-voice
A voice recording and transcription tool for Hyprland, using Whisper for speech-to-text and copying results to clipboard. It's using Faster Whisper (optimized for CPU) and runs fully locally.
https://github.com/jpzk/wl-voice
hyprland hyprland-dotfiles hyprland-rice wayland whisper whisper-ai
Last synced: 28 days ago
JSON representation
A voice recording and transcription tool for Hyprland, using Whisper for speech-to-text and copying results to clipboard. It's using Faster Whisper (optimized for CPU) and runs fully locally.
- Host: GitHub
- URL: https://github.com/jpzk/wl-voice
- Owner: jpzk
- Created: 2025-09-08T09:02:52.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-09-08T10:02:16.000Z (about 1 month ago)
- Last Synced: 2025-09-08T11:23:42.631Z (about 1 month ago)
- Topics: hyprland, hyprland-dotfiles, hyprland-rice, wayland, whisper, whisper-ai
- Language: Python
- Homepage:
- Size: 563 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# wl-voice
A voice recording and transcription tool for Hyprland, using Whisper for speech-to-text and copying results to clipboard. It's using Faster Whisper (optimized for CPU) and runs **fully locally**.
## Installation
1. Ensure you have `uv` installed (Python package manager).
2. Run `make install` to build and install the daemon and CLI tools.
- This creates a virtual environment, installs dependencies, builds executables with PyInstaller, and copies them to `/usr/local/bin`.
3. To uninstall, run `make uninstall`.
## Usage
1. Start the daemon: `wl-voiced` (run in background or as a service).
2. Use the CLI to control recording:
- Start recording: `wl-voice start`
- Stop recording and transcribe: `wl-voice stop`
The transcribed text will be copied to your clipboard and a notification will appear.
## Hyprland Setup
Add the following bindings to your Hyprland config (`~/.config/hypr/hyprland.conf`):
```
# Start recording
bind = SUPER, R, exec, wl-voice start
# Stop recording and transcribe
bind = SUPER, S, exec, wl-voice stop
```
Ensure the daemon is running before using the bindings. You can add `wl-voiced` to your startup applications.
## Starting the Daemon with Hyprland
To automatically start the wl-voiced daemon when Hyprland launches, add the following line to your Hyprland config (`~/.config/hypr/hyprland.conf`):
```
exec-once = wl-voiced
```
This ensures the daemon is running in the background whenever you start Hyprland.