whisrs

Voice for the Linux desktop: dictation, read-aloud, and voice-driven LLM commands. Wayland & X11: Hyprland, Sway, Niri, GNOME, KDE. Cloud or fully offline. Writ

What is whisrs?

Voice for the Linux desktop: dictation, read-aloud, and voice-driven LLM commands. Wayland & X11: Hyprland, Sway, Niri, GNOME, KDE. Cloud or fully offline. Written in Rust.

Overview of whisrs

What it is

whisrs is a voice control tool for the Linux desktop, written in Rust. It provides dictation, read-aloud, and voice-driven LLM commands. It supports Wayland and X11 compositors including Hyprland, Sway, Niri, GNOME, and KDE. It can use cloud transcription backends (Groq, Deepgram, OpenAI) or run fully offline via whisper.cpp. It also records microphone and system audio into a single timestamped Markdown transcript.

Key features

  • Dictation: press a hotkey, speak, and text appears at the cursor in any application.
  • Read-aloud: select text and whisrs reads it aloud using text-to-speech via Groq, OpenAI, Deepgram, or a local sidecar.
  • Voice-driven LLM commands: say what you want and an LLM writes it at your cursor, or talk to a coding agent (Claude Code, OpenCode, Codex, GitHub Copilot).
  • Supports cloud transcription (Groq, Deepgram, OpenAI) and fully offline local transcription via whisper.cpp.
  • Records microphone and system audio into a single timestamped Markdown transcript kept in its own folder.
  • Layout-aware keyboard injection with AltGr and dead keys support, per-compositor window tracking, and pluggable backends.

Use cases

Dictation for writing emails, documents, or code on Linux. Reading selected text aloud for proofreading or accessibility. Voice commands to control LLMs or coding agents without touching the keyboard. Recording meetings or conversations with both microphone and system audio into a structured transcript.

Getting started

Quick install (Linux x86_64 / aarch64):bashcurl -sSL https://y0sif.github.io/whisrs/install.sh | bashAfter install, run whisrs setup to configure your backend, API keys, permissions, and keybindings. Then bind a hotkey (e.g., in Hyprland: bind = $mainMod, W, exec, whisrs toggle). Press the hotkey to start recording, press again to stop; text appears at your cursor.

License and pricing

License: MIT. Pricing: open source (free).

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/y0sifwhisrs.svg)](https://yunodb.com/tools/y0sifwhisrs?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/y0sifwhisrs?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/y0sifwhisrs.svg" alt="Featured on YunoDB" height="20"></a>