Vocalinux v0.16.1
Vocalinux 0.16.1 is a patch on the 0.16 line. It fixes desktop and install bugs that showed up after 0.16.0: the wrong speech model at startup, leftover tray state after toggle stop, paste into terminals, GNOME XWayland layout after inject, and AppImages that needed a glibc newer than Debian 12. The installer now requires Python 3.11 and checks model downloads against pinned checksums. The AUR package builds on Arch extra setuptools 84, and AUR pywhispercpp 1.4 no longer dies on context_params.
Highlights
| Area | Description |
|---|---|
| Speech models | Start on the engine's own model size; save the model only after it loaded |
| Tray | Stay idle after leftover transcription; download the recommended model from the missing-model notification |
| Injection | Ctrl+Shift+V paste in terminals; keep the GNOME XWayland layout after IBus |
| Installer | Python 3.11 floor, verified downloads, no invented GPUs |
| AppImage | glibc floor that boots on Debian 12 through current Fedora |
| AUR | Build against Arch extra setuptools 84; skip context_params on AUR pywhispercpp 1.4 |
| Settings | Even dropdowns and a quieter About page |
New Features
- Tray: the missing-model notification can download the recommended model. (#687 by @kacperpaczos)
Bug Fixes
- Startup: resolve model size per engine instead of the leftover generic
model_sizekey, so a VOSK save does not make whisper.cpp look for a missing medium model. (#684 by @kacperpaczos, fixes #681) - Settings: save the model only after the engine loaded it, so a cancelled or failed download does not leave config pointing at a file that is not on disk. (#685 by @kacperpaczos)
- Settings: unused downloads list sized to its real rows so leftover models are not clipped. (#686 by @kacperpaczos, fixes #683)
- Config: one ConfigManager for the process so Settings writes are not overwritten by a stale cache. (#691 by @kacperpaczos, fixes #689)
- Tray: stay idle after leftover transcription on toggle stop. (#741 by @jatinkrmalik)
- Injection: Ctrl+Shift+V when pasting into terminals, so Ctrl+V is not treated as verbatim insert. (#734 by @jatinkrmalik)
- IBus: sync the XWayland layout from GNOME after scoped inject. (#742 by @jatinkrmalik)
- Installer: survive a release without a checksum manifest, and stop inventing GPUs. (#736 by @sesav)
- Installer: leftover engine repair,
just --no-sync, ggml verify from #713. (#732 by @jatinkrmalik) - AUR: drop the
setuptools<82cap sopython -m build --no-isolationworks with Arch extra python-setuptools 84. (#757) - whisper.cpp: skip
context_paramson pywhispercpp older than 1.5 (AUR cpu/cuda/rocm are still 1.4.x), so startup no longer dies withwhisper_full_paramshas nocontext_params. (#757, also #626 / #625)
Improvements
- Settings: even dropdown widths, quieter About page, family platform marks. (#754 by @jatinkrmalik)
- UI: use the canonical VocaHQ Discord invite. (#749 by @jatinkrmalik)
Docs
- VocaWin is unsigned beta, still not a Store ship. (#733 by @jatinkrmalik)
- Screenshots page labeled v0.16. (#735 by @jatinkrmalik)
- README family status and on-device copy. (#737 by @jatinkrmalik)
- AUR troubleshooting for the setuptools and pywhispercpp 1.4 crashes. (#757)
Packaging
- Python 3.11 floor, uv tooling, verified model downloads (epic #701 phases 2.5 and 5). Ubuntu 22.04 is out: jammy's python3 is 3.10. (#713 by @sesav)
- AppImage built against a glibc floor Debian 12 can run. (#743 by @sesav)
- AppImage boot tests on six distros. (#744 by @sesav)
CI / maintenance
- Tests: stop leaking
Factory.newonto MagicMock. (#748 by @jatinkrmalik)
Thanks
Thank you @kacperpaczos for the per-engine model startup, save-after-load, leftover-download list, shared ConfigManager, and the recommended-model tray download (#684, #685, #686, #691, #687).
Thank you @sesav for the Python 3.11 floor, verified downloads, installer GPU/checksum fixes, and the AppImage glibc work that actually boots on Debian 12 (#713, #736, #743, #744).
Thank you simona, avocadoboat, and Masalababa for the AUR reports that became #757.
Thanks to everyone who filed bugs and tested builds on the way to 0.16.1.
Install / Upgrade
Recommended (install.sh)
curl -fsSL https://raw.githubusercontent.com/VocaHQ/vocalinux/main/install.sh -o /tmp/vl.sh && bash /tmp/vl.shThe installer needs Python 3.11 or newer and distro python3-gi / python3-gobject. It no longer pip-builds PyGObject from sdist. Ubuntu 22.04 is not supported.
AppImage
Download Vocalinux-0.16.1-x86_64.AppImage or Vocalinux-0.16.1-aarch64.AppImage from this release:
chmod +x Vocalinux-0.16.1-x86_64.AppImage
./Vocalinux-0.16.1-x86_64.AppImageHost text-injection tools (xdotool, wtype, or ydotool) are still required, same as a PyPI install. FUSE is needed to run the AppImage on most hosts.
Arch Linux (AUR)
yay -Syu vocalinuxThe AUR package is published from this tag. Give the Publish to AUR job a few minutes after the GitHub Release appears, then rebuild.
PyPI
pip install -U vocalinuxPyPI is the Python package only. For system deps, desktop integration, and models, use install.sh.
Flatpak
Local build notes live under packaging/flatpak/. Flathub may still trail this tag.
Upgrade details: docs/UPDATE.md
Full changelog: v0.16.0...v0.16.1