Skip to main content

​
Requirements

  • x64 architecture
  • PulseAudio or PipeWire for audio

​
Package formats

FormatDistros
.AppImageAny (portable, no install)
.debDebian, Ubuntu, Mint, Pop!_OS
.rpmFedora, RHEL, openSUSE
.tar.gzUniversal archive
.flatpakCross-distro sandboxed
chmod +x OpenWhispr-*.AppImage
./OpenWhispr-*.AppImage

​
Auto-paste

OpenWhispr ships a native C binary (linux-fast-paste) for pasting text. It works on both X11 and Wayland. If the native binary isn’t available, install one of these fallbacks: 
sudo apt install xdotool    # Debian/Ubuntu
sudo dnf install xdotool    # Fedora
sudo pacman -S xdotool      # Arch
Text is always copied to the clipboard regardless — if no paste tool works, use Ctrl+V manually.

​
Wayland hotkeys

Electron’s global shortcuts don’t work on Wayland. OpenWhispr handles this automatically per compositor:

​
GNOME

Uses native GNOME shortcuts via D-Bus and gsettings. Hotkeys appear in Settings > Keyboard > Shortcuts > Custom.
  • Default hotkey: Alt+R (backtick not supported on GNOME Wayland)
  • Push-to-talk not available (GNOME shortcuts fire a single toggle event)

​
KDE Plasma

Uses native KDE shortcuts via D-Bus.

​
Hyprland

Uses hyprctl keyword bind for runtime keybinding. Requires hyprctl on PATH (ships with Hyprland).
  • Push-to-talk not available
  • Bindings are re-registered on each app startup

​
Meeting audio (Linux)

System audio capture uses the desktop portal chooser. Select the audio source when prompted at the start of a meeting recording.

​
Uninstalling

  • deb/rpm — post-uninstall scripts remove cached models
  • Other formats — manually remove ~/.cache/openwhispr/ if desired