> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openwhispr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux

> Linux-specific setup including Wayland, paste tools, and package formats.

## Requirements

* x64 architecture
* PulseAudio or PipeWire for audio

## Package formats

| Format      | Distros                        |
| ----------- | ------------------------------ |
| `.AppImage` | Any (portable, no install)     |
| `.deb`      | Debian, Ubuntu, Mint, Pop!\_OS |
| `.rpm`      | Fedora, RHEL, openSUSE         |
| `.tar.gz`   | Universal archive              |

<Tabs>
  <Tab title="AppImage">
    ```bash theme={null}
    chmod +x OpenWhispr-*.AppImage
    ./OpenWhispr-*.AppImage
    ```
  </Tab>

  <Tab title="deb">
    ```bash theme={null}
    sudo apt install ./OpenWhispr-*-linux-x64.deb
    ```
  </Tab>

  <Tab title="rpm">
    ```bash theme={null}
    sudo dnf install ./OpenWhispr-*-linux-x64.rpm
    ```
  </Tab>

  <Tab title="tar.gz">
    ```bash theme={null}
    tar -xzf OpenWhispr-*-linux-x64.tar.gz
    cd OpenWhispr-*/
    ./openwhispr
    ```
  </Tab>
</Tabs>

## 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:

<Tabs>
  <Tab title="X11">
    ```bash theme={null}
    sudo apt install xdotool    # Debian/Ubuntu
    sudo dnf install xdotool    # Fedora
    sudo pacman -S xdotool      # Arch
    ```
  </Tab>

  <Tab title="Wayland">
    ```bash theme={null}
    # Option 1: wtype
    sudo apt install wtype

    # Option 2: ydotool (requires daemon)
    sudo apt install ydotool
    sudo systemctl enable --now ydotoold
    ```
  </Tab>
</Tabs>

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 fallback: `F8` when `Ctrl+Super` cannot be registered
* 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