v0.14.1

Vocalinux v0.14.1

Vocalinux 0.14.1 is a packaging and reliability release (stable tag of 0.14.1-beta for Flathub). You can install via Flatpak and AUR, and several installer and Wayland paste bugs that showed up right after 0.14.0 are fixed.

---

Highlights

Feature	Description
Flatpak packaging	Universal Flatpak on GNOME Platform 50 with whisper.cpp, global hotkeys, and Wayland paste (ydotool + wl-copy)
AUR package	Official Arch packaging with CI publish
Layout-aware hotkeys	Combo shortcuts respect non-US keyboard layouts
Installer + paste fixes	Broken launch wrappers, sg on newer Ubuntu/Debian, ydotool 0.1.x vs 1.x Ctrl+V, Flatpak ydotoold socket probe

---

New Features

• Flatpak packaging. GNOME Platform 50, whisper.cpp (Vulkan when available), evdev global hotkeys, and text injection via wl-copy + ydotool (xdotool fallback). Build from packaging/flatpak/. Flathub submission is in progress. (#484 by @jatinkrmalik, closes #167)
• AUR release package. PKGBUILD and CI publish path for Arch Linux. (#518 by @jatinkrmalik; feature request #116 by @nxtkofi)

---

Bug Fixes

• Hotkeys: Layout-aware combo keys so modifier+letter shortcuts work on non-US layouts. (#514 by @jatinkrmalik, fixes #513 reported by @laurentpayot)
• Installer: Expand EXEC_CMD correctly in ~/.local/bin wrappers so vocalinux no longer fails with a missing command after install.
• Installer: Honor absolute --venv-dir paths (no nested repo/home/.../venv).
• Installer: Avoid requiring sg when it is missing on Ubuntu 26.04 / Debian 13. (#524 by @jatinkrmalik, fixes #522 reported by @OpenUAS)
• Text injection: Treat XIM none as unset so injection does not skip useful backends. (#512 by @jatinkrmalik, fixes #511 reported by @canis-lupus03)
• Wayland paste (ydotool): Use ctrl+v on distro ydotool 0.1.x and keycode chords on ydotool 1.x (Flatpak pins 1.0.4). Stops host installs typing garbage like 2442 instead of pasting.
• Wayland paste (Flatpak): Probe ydotoold with a real connect on the Unix datagram socket, drop only dead sockets, and start the daemon when needed. Fixes paste exit status 2 after a previous session.
• Models: HTTP timeouts and clearer errors when Hugging Face is slow or returns HTML; HF downloads use ?download=true.
• Web: Dependabot npm fixes in the website lockfile. (#515 by @jatinkrmalik; also #510 by @dependabot)

---

Docs

• Refreshed v0.14 UI screenshots and website gallery. (#521 by @jatinkrmalik)
• README Star History and related polish.

---

Since 0.14.1-beta

• Flathub domain verification: empty well-known file at /.well-known/org.flathub.VerifiedApps.txt on vocalinux.com (#530 by @jatinkrmalik)
• Stable release tag for Flathub: drop the -beta AppStream/version suffix so Flathub stable lint accepts the build (#532 by @jatinkrmalik)

---

Install / Upgrade

Recommended (install.sh)

curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/main/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh

From the release tag

cd vocalinux
git fetch origin
git checkout v0.14.1
./install.sh

Arch Linux (AUR)

yay -S vocalinux

Flatpak (local build; Flathub pending review)

flatpak install flathub org.gnome.Platform//50 org.gnome.Sdk//50
git clone https://github.com/jatinkrmalik/vocalinux.git && cd vocalinux
git checkout v0.14.1
flatpak-builder --user --force-clean --install build-dir packaging/flatpak/com.vocalinux.Vocalinux.yml
flatpak run com.vocalinux.Vocalinux

---

Notes

• Flatpak and host (install.sh) installs should not be run at the same time; they can fight over the ydotool socket and the mic.
• First-run model downloads need network access to Hugging Face. If HF is down, retry later or keep using a model already under ~/.local/share/vocalinux/models/.

---

Thanks

Thanks to everyone who contributed to this release:

Pull Requests:

• @jatinkrmalik: Flatpak packaging (#484), AUR package (#518), layout-aware hotkeys (#514), installer sg fix (#524), XIM none handling (#512), web security updates (#515), screenshots (#521), release prep (#525), Flathub domain verification (#530), stable 0.14.1 for Flathub (#532)
• @dependabot: npm ws bump (#510)

Issue reporters:

• @laurentpayot: custom shortcuts recorded as QWERTY on non-US layouts (#513)
• @OpenUAS: sg: not found on Ubuntu 26.04 / Debian 13 (#522)
• @canis-lupus03: text injection still failing on KDE Plasma Wayland with XIM none (#511)
• @nxtkofi: AUR packaging request (#116)

Full changelog: v0.14.0-beta...v0.14.1