chore(release): prepare v0.10.0-beta (#345)
* chore(release): prepare v0.10.0-beta Bump versions and release references across app, docs, installer, and website for the next beta release. Add v0.10.0-beta release notes entries covering reliability fixes and CI/test improvements since v0.9.0-beta. Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai> * docs(release): align Python baseline references to 3.9+ Synchronize stale Python 3.8 references in agent guidance and distro dependency docs/scripts with the current 3.9+ minimum used by project metadata and release docs. Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai> --------- Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
Jatin K Malik
co-authored by
Sisyphus
Sisyphus
parent
ca39ba930e
commit
84ec79c769
@@ -5,7 +5,7 @@ Guidelines for AI agents working on this codebase.
|
||||
## Project Overview
|
||||
|
||||
Vocalinux is a voice dictation system for Linux. It uses:
|
||||
- **Python 3.8+** for the main application
|
||||
- **Python 3.9+** for the main application
|
||||
- **GTK 3** (via PyGObject) for the desktop UI and system tray
|
||||
- **whisper.cpp** (default), **OpenAI Whisper**, and **Vosk** for speech recognition
|
||||
- **Next.js/TypeScript** for the website (in `web/`)
|
||||
|
||||
@@ -32,38 +32,39 @@ It's a free, GPLv3-licensed desktop app that lets you dictate text into *any* ap
|
||||
|
||||
No internet required. No data leaves your machine. Just speak and type.
|
||||
|
||||
## 📚 What's New in v0.9.0-beta
|
||||
## 📚 What's New in v0.10.0-beta
|
||||
|
||||
> 🎉 **Release: Left/Right modifier keys, sound effects toggle, Wayland clipboard fallback, and more.**
|
||||
> 🎉 **Release: reliability hardening across keyboard/audio/tray handling, stronger IBus activation, and better CI/testing quality.**
|
||||
|
||||
### 🚀 Highlights (v0.8.0 → v0.9.0)
|
||||
### 🚀 Highlights (v0.9.0 → v0.10.0)
|
||||
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| **⌨️ Left/Right Modifier Keys** | Choose Left Ctrl vs Right Ctrl (etc.) as your shortcut trigger |
|
||||
| **🔔 Sound Effects Toggle** | Enable or disable audio feedback from the Settings dialog |
|
||||
| **📋 Wayland Clipboard Fallback** | Automatic clipboard copy when virtual keyboard injection isn't available |
|
||||
| **🛠️ Installation Polish** | Better pipx/Debian guidance and headless display detection |
|
||||
| **⌨️ Keyboard Robustness** | Better modifier alias matching across layouts and SYN_DROPPED recovery in evdev |
|
||||
| **🎙️ Audio Compatibility** | Device channel probing now validates supported sample rates for safer defaults |
|
||||
| **🖥️ IBus + Tray Stability** | IBus activation uses `register_component`; tray updates use icon names reliably |
|
||||
| **🧪 Quality & CI Upgrades** | Test coverage rose to 80%+, with Node 24 and path-filtered CI pipelines |
|
||||
|
||||
### ✨ New Features (v0.9.0)
|
||||
### ✨ New in v0.10.0-beta
|
||||
|
||||
- **Left/Right Modifier Key Distinction** - Shortcuts now support `Left Ctrl`, `Right Alt`, etc., with grouped UI in Settings
|
||||
- **Sound Effects Toggle** - New Audio Settings toggle to silence start/stop/error sounds
|
||||
- **Clipboard Fallback for Wayland** - Auto-copies text via `wl-copy`/`xclip` when injection unavailable (KDE Plasma etc.)
|
||||
- **Display Availability Check** - Graceful error message when running in headless environments
|
||||
- **IBus registration flow improvements** - Text injection now uses explicit component registration for more reliable engine activation
|
||||
- **Expanded IBus test coverage** - Launch mode and main entrypoint paths are now covered in tests
|
||||
- **Improved project defaults** - Minimum supported Python version is now 3.9+
|
||||
|
||||
### 🐛 Bug Fixes (v0.9.0)
|
||||
### 🐛 Bug Fixes (v0.10.0)
|
||||
|
||||
- **#308**: Distinguish left vs right modifier keys (evdev + pynput backends)
|
||||
- **#307**: Remove unwanted leading space when starting a new transcription session
|
||||
- **#305**: Pass configured shortcut mode to `KeyboardShortcutManager` on startup
|
||||
- **#299**: Add clipboard fallback for Wayland compositors without virtual keyboard support
|
||||
- **#289**: Improve Debian/pipx installation error messages and cross-distro dependency guidance
|
||||
- **#342**: Generalized pynput modifier alias matching across keyboard layouts
|
||||
- **#341**: Channel probing now verifies sample-rate support for selected audio devices
|
||||
- **#339**: evdev backend now handles `SYN_DROPPED` to avoid stale modifier state
|
||||
- **#333**: Settings dialog now forces window decorations to fix missing-titlebar scenarios
|
||||
- **#330**: Tray icon updates now use icon names for AppIndicator compatibility
|
||||
- **#304**: IBus activation now uses `register_component` for more reliable startup behavior
|
||||
|
||||
### 🔧 Improvements
|
||||
|
||||
- **Grouped shortcut selector** - Settings dropdown now organises shortcuts by Either/Left/Right side
|
||||
- **pipx documentation** - New `DISTRO_COMPATIBILITY.md` section for pipx users
|
||||
- **Installation fallback hardening** - Installer now resolves latest tag via GitHub API and improves piped-shell behavior
|
||||
- **CI runtime modernization** - Deploy workflow upgraded to Node.js 24 with smarter path-based workflow filtering
|
||||
- **Repo cleanup** - Removed stale `setup.py` and legacy website build script
|
||||
|
||||
---
|
||||
|
||||
@@ -367,7 +368,7 @@ Vocalinux is part of a family of privacy-first, offline voice dictation tools. S
|
||||
|
||||
| Platform | Project | Website | GitHub | Status |
|
||||
|----------|---------|---------|--------|--------|
|
||||
| 🐧 Linux | **VocaLinux** | [vocalinux.com](https://vocalinux.com) | [jatinkrmalik/vocalinux](https://github.com/jatinkrmalik/vocalinux) | ✅ Beta v0.9.0 |
|
||||
| 🐧 Linux | **VocaLinux** | [vocalinux.com](https://vocalinux.com) | [jatinkrmalik/vocalinux](https://github.com/jatinkrmalik/vocalinux) | ✅ Beta v0.10.0 |
|
||||
| 🍎 macOS | **VocaMac** | [vocamac.com](https://vocamac.com) | [jatinkrmalik/vocamac](https://github.com/jatinkrmalik/vocamac) | 🚀 Beta |
|
||||
| 🪟 Windows | **VocaWin** | [vocawin.com](https://vocawin.com) | [jatinkrmalik/vocawin](https://github.com/jatinkrmalik/vocawin) | 📋 Planned |
|
||||
|
||||
|
||||
+3
-3
@@ -4,10 +4,10 @@
|
||||
|
||||
| Version | Supported |
|
||||
| ------- | ------------------ |
|
||||
| 0.9.x | :white_check_mark: |
|
||||
| 0.10.x | :white_check_mark: |
|
||||
| 0.9.x | :x: |
|
||||
| 0.8.x | :x: |
|
||||
| 0.7.x | :x: |
|
||||
| < 0.7 | :x: |
|
||||
| < 0.8 | :x: |
|
||||
|
||||
## Reporting a Vulnerability
|
||||
|
||||
|
||||
@@ -328,6 +328,7 @@ git push origin v0.5.1-beta
|
||||
| 0.7.0-beta | 2026 | Beta | Autostart, tabbed settings, Intel GPU support, single instance |
|
||||
| 0.8.0-beta | 2026-03-01 | Beta | Push-to-talk mode, optional voice commands, input/audio compatibility fixes |
|
||||
| 0.9.0-beta | 2026-03-14 | Beta | Left/right modifier keys, sound effects toggle, Wayland clipboard fallback, leading-space fix |
|
||||
| 0.10.0-beta | 2026-03-25 | Beta | Keyboard/audio reliability hardening, IBus/tray stability fixes, CI + test coverage improvements |
|
||||
|
||||
## Questions?
|
||||
|
||||
|
||||
+37
-1
@@ -2,6 +2,42 @@
|
||||
|
||||
This guide explains how to update Vocalinux to the latest version.
|
||||
|
||||
## What's New in v0.10.0-beta
|
||||
|
||||
### 🚀 Highlights
|
||||
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| **⌨️ Keyboard Robustness** | Better modifier alias handling across layouts and evdev `SYN_DROPPED` recovery |
|
||||
| **🎙️ Audio Compatibility** | Audio channel probing now validates sample-rate support per device |
|
||||
| **🖥️ IBus + Tray Stability** | IBus activation is more reliable and tray icon refresh is more consistent |
|
||||
| **🧪 Testing & CI Upgrades** | Coverage increased to 80%+, with modernized Node 24 CI workflows |
|
||||
|
||||
### ✨ New Features
|
||||
|
||||
- **IBus registration improvements** — Text injection activation now uses `register_component`
|
||||
- **Expanded IBus test coverage** — Added launch-mode and main-entrypoint test paths
|
||||
- **Python baseline update** — Minimum supported Python version is now 3.9+
|
||||
|
||||
### 🐛 Bug Fixes
|
||||
|
||||
- **#342**: Generalize pynput modifier alias matching across layouts
|
||||
- **#341**: Probe audio channels using device-supported sample rates
|
||||
- **#339**: Handle evdev `SYN_DROPPED` to prevent stale modifier state
|
||||
- **#333**: Force window decorations in settings dialog
|
||||
- **#330**: Use icon names for AppIndicator tray updates
|
||||
- **#304**: Use `register_component` for IBus engine activation
|
||||
|
||||
### 🔧 Improvements
|
||||
|
||||
- Installer fallback now resolves latest tag through GitHub API and better handles piped shell execution
|
||||
- CI now uses Node.js 24 for website deployment and path-based filtering to skip unnecessary workflows
|
||||
- Removed stale `setup.py` and legacy `build-website.sh`
|
||||
|
||||
See the [full changelog](https://github.com/jatinkrmalik/vocalinux/releases/tag/v0.10.0-beta).
|
||||
|
||||
---
|
||||
|
||||
## What's New in v0.9.0-beta
|
||||
|
||||
### 🚀 Highlights
|
||||
@@ -93,7 +129,7 @@ The installer will:
|
||||
```bash
|
||||
cd vocalinux
|
||||
git fetch origin
|
||||
git checkout v0.9.0-beta
|
||||
git checkout v0.10.0-beta
|
||||
./install.sh
|
||||
```
|
||||
|
||||
|
||||
+1
-1
@@ -235,7 +235,7 @@ resolve_install_tag() {
|
||||
return
|
||||
fi
|
||||
fi
|
||||
INSTALL_TAG="v0.9.0-beta"
|
||||
INSTALL_TAG="v0.10.0-beta"
|
||||
}
|
||||
|
||||
resolve_install_tag
|
||||
|
||||
@@ -9,14 +9,14 @@ check_deps() {
|
||||
echo "Checking Vocalinux system dependencies..."
|
||||
echo ""
|
||||
|
||||
# Check for Python 3.8+
|
||||
# Check for Python 3.9+
|
||||
if command -v python3 >/dev/null 2>&1; then
|
||||
PY_VERSION=$(python3 -c "import sys; print('.'.join(map(str, sys.version_info[:2])))")
|
||||
echo "✓ Python $PY_VERSION"
|
||||
|
||||
if [ "$(echo "$PY_VERSION" | cut -d. -f1)" -lt 3 ] || \
|
||||
[ "$(echo "$PY_VERSION" | cut -d. -f2)" -lt 8 ]; then
|
||||
echo " ✗ Python 3.8+ required, found $PY_VERSION"
|
||||
[ "$(echo "$PY_VERSION" | cut -d. -f2)" -lt 9 ]; then
|
||||
echo " ✗ Python 3.9+ required, found $PY_VERSION"
|
||||
MISSING=1
|
||||
fi
|
||||
else
|
||||
@@ -127,7 +127,7 @@ check_deps() {
|
||||
echo " sudo zypper install -y python3-gobject python3-gobject-cairo gtk3 gobject-introspection-devel portaudio-devel python3-devel python3-virtualenv pkg-config xdotool wtype"
|
||||
elif [[ "$DETECTED_DISTRO" == "gentoo" ]]; then
|
||||
echo "Gentoo:"
|
||||
echo " sudo emerge dev-python/pygobject:3 x11-libs/gtk+:3 dev-libs/libappindicator:3 media-libs/portaudio dev-lang/python:3.8 xdotool wtype"
|
||||
echo " sudo emerge dev-python/pygobject:3 x11-libs/gtk+:3 dev-libs/libappindicator:3 media-libs/portaudio dev-lang/python:3.9 xdotool wtype"
|
||||
elif [[ "$DETECTED_DISTRO" == "alpine" ]]; then
|
||||
echo "Alpine Linux:"
|
||||
echo " sudo apk add py3-gobject3 py3-pip gtk+3.0 py3-cairo portaudio-dev py3-virtualenv pkgconf xdotool wtype"
|
||||
|
||||
@@ -48,7 +48,7 @@ system_packages:
|
||||
fedora: ["python3-devel", "python3-virtualenv"]
|
||||
arch: ["python"] # Arch includes venv by default
|
||||
opensuse: ["python3-devel", "python3-virtualenv"]
|
||||
gentoo: ["dev-lang/python:3.8"]
|
||||
gentoo: ["dev-lang/python:3.9"]
|
||||
alpine: ["py3-virtualenv"]
|
||||
void: ["python3-devel"]
|
||||
solus: ["python3-virtualenv"]
|
||||
@@ -196,7 +196,7 @@ distribution_notes:
|
||||
|
||||
gentoo:
|
||||
general: "Gentoo compiles packages from source. Installation will take longer."
|
||||
python: "Ensure Python 3.8+ is set as the active version"
|
||||
python: "Ensure Python 3.9+ is set as the active version"
|
||||
|
||||
alpine:
|
||||
general: "Alpine uses musl libc. Some Python packages may not have pre-built wheels."
|
||||
|
||||
@@ -2,8 +2,8 @@
|
||||
Version information for Vocalinux.
|
||||
"""
|
||||
|
||||
__version__ = "0.9.0-beta"
|
||||
__version_info__ = (0, 9, 0, "beta")
|
||||
__version__ = "0.10.0-beta"
|
||||
__version_info__ = (0, 10, 0, "beta")
|
||||
__author__ = "Jatin K Malik"
|
||||
__email__ = "jatinkrmalik@gmail.com"
|
||||
__license__ = "GPL-3.0"
|
||||
|
||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "vocalinux-website",
|
||||
"version": "0.8.0",
|
||||
"version": "0.10.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "vocalinux-website",
|
||||
"version": "0.8.0",
|
||||
"version": "0.10.0",
|
||||
"dependencies": {
|
||||
"@types/node": "^20.14.10",
|
||||
"@types/react": "^18.3.3",
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "vocalinux-website",
|
||||
"version": "0.9.0",
|
||||
"version": "0.10.0",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
|
||||
@@ -5,6 +5,21 @@ import { SeoSubpageShell } from "@/components/seo-subpage-shell";
|
||||
import { absoluteUrl, buildPageMetadata } from "@/lib/seo";
|
||||
|
||||
const releases = [
|
||||
{
|
||||
version: "v0.10.0-beta",
|
||||
date: "2026-03-25",
|
||||
type: "beta",
|
||||
highlights: [
|
||||
"Generalized keyboard modifier alias matching across layouts for more reliable shortcuts",
|
||||
"Audio channel probing now validates device-supported sample rates before selection",
|
||||
"evdev now handles SYN_DROPPED to prevent stale modifier state",
|
||||
"IBus engine activation now uses register_component for stronger text-injection startup",
|
||||
"Settings dialog forces window decorations to prevent missing-titlebar behavior",
|
||||
"Tray icon refresh now uses icon names for better AppIndicator compatibility",
|
||||
"Coverage increased to 80%+ with additional IBus launch/main-entry tests",
|
||||
"Installer and CI polish: latest-tag fallback via GitHub API, Node 24 deploy, and path-filtered workflows",
|
||||
],
|
||||
},
|
||||
{
|
||||
version: "v0.9.0-beta",
|
||||
date: "2026-03-14",
|
||||
@@ -175,7 +190,7 @@ export default function ChangelogPage() {
|
||||
headline: "Vocalinux Changelog - Release History",
|
||||
description:
|
||||
"Complete release history for Vocalinux, the offline voice dictation software for Linux.",
|
||||
dateModified: "2026-03-14",
|
||||
dateModified: "2026-03-25",
|
||||
author: {
|
||||
"@type": "Person",
|
||||
name: "Jatin K Malik",
|
||||
|
||||
@@ -64,7 +64,7 @@ const homeJsonLd = [
|
||||
},
|
||||
description:
|
||||
"Offline voice dictation and speech-to-text for Linux with whisper.cpp and VOSK.",
|
||||
"softwareVersion": "0.9.0-beta",
|
||||
"softwareVersion": "0.10.0-beta",
|
||||
author: {
|
||||
"@type": "Person",
|
||||
name: "Jatin K Malik",
|
||||
@@ -290,7 +290,7 @@ export default function HomePage() {
|
||||
/>
|
||||
<span className="font-bold text-lg sm:text-xl">Vocalinux</span>
|
||||
<span className="hidden sm:inline-block text-xs bg-gradient-to-r from-primary/20 to-green-500/20 text-primary border border-primary/30 px-2.5 py-1 rounded-full font-semibold shadow-sm shadow-primary/20">
|
||||
v0.9.0 Beta
|
||||
v0.10.0 Beta
|
||||
</span>
|
||||
</Link>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user