Files
voculinux/docs/UPDATE.md
T
Jatin K MalikandGitHub 6e02e928ae chore(release): prepare v0.7.0-beta (#255)
* chore(release): prepare v0.7.0-beta

## Version Bump (v0.6.3-beta → v0.7.0-beta)

This is a major beta release with significant new features including autostart support, tabbed settings, and improved GPU detection.

### Core Version Files
- Updated src/vocalinux/version.py to 0.7.0-beta
- Updated pyproject.toml classifiers (already correct - Beta)

### Documentation
- Updated README.md with new features, bug fixes, and version references
- Updated docs/INSTALL.md with v0.7.0-beta install commands
- Updated docs/UPDATE.md with comprehensive 'What's New' section
- Updated SECURITY.md supported versions table (0.7.x now supported)

### Website
- Updated web/src/app/page.tsx version badge (v0.7.0 Beta)
- Updated web/src/app/page.tsx softwareVersion schema
- Updated web/package.json version to 0.7.0
- Updated web/src/app/changelog/page.tsx with v0.7.0-beta release entry

### Other Updates
- Updated install.sh default tag to v0.7.0-beta
- Updated src/vocalinux/main.py error message install command
- Updated AGENTS.md branch naming example

## Changes Since v0.6.3-beta

### New Features (13 commits)
- Autostart on login support via XDG autostart
- Tabbed settings dialog with 5 organized tabs
- Intel GPU compatibility detection with automatic CPU fallback
- Single instance prevention
- Evdev device management to prevent CPU spin
- Improved GPU detection avoiding false positives
- IBus fallback when daemon not running
- Fedora dnf check-update fix
- Web SEO - 7 new optimized pages

### Contributors
- Jatin K Malik (maintainer)
- Antoine Monnet (contributor)
- jatinkrmalik (contributor)

### Bug Fixes
- #254: Improved GPU detection to avoid false positives
- #251: Skip IBus setup when daemon not running
- #243: Prevent dnf check-update from exiting script on Fedora
- #240: Raise exception on IBus setup failure
- #234: Removed leading space from first speech transcription
- #242/#253: Removed disconnected evdev devices to prevent CPU spin

## Verification
- [x] Lint passed
- [x] Black formatting passed
- [x] isort check passed
- [x] Version imports correctly as 0.7.0-beta

* docs: update version history in RELEASE_PROCESS.md

Add entries for 0.6.0-beta through 0.7.0-beta to the version history table.
2026-02-22 21:30:05 -08:00

3.7 KiB

Updating Vocalinux

This guide explains how to update Vocalinux to the latest version.

What's New in v0.7.0-beta

🚀 Highlights

Feature Description
🖥️ Autostart Support Launch Vocalinux automatically on desktop session startup
⚙️ Tabbed Settings Completely redesigned settings dialog with organized tabs
🎮 Intel GPU Detection Automatically detects incompatible Intel GPUs and falls back to CPU
🔒 Single Instance Prevents multiple Vocalinux instances from running simultaneously

✨ New Features

  • Autostart on Login — Added XDG autostart support via settings dialog and system tray
  • Tabbed Settings Dialog — Reorganized settings into Speech Engine, Recognition, Text Injection, Audio Feedback, and General tabs
  • Intel GPU Compatibility Detection — Detects incompatible Intel GPUs and automatically falls back to CPU processing
  • Multiple Instance Prevention — Shows notification and exits if Vocalinux is already running
  • Evdev Device Management — Automatically removes disconnected input devices to prevent CPU spin

🐛 Bug Fixes

  • #254: Improved GPU detection to avoid false positives on systems without dev libraries
  • #251: Skip IBus setup when daemon is not running, enable fallback to other methods
  • #243: Prevent dnf check-update from exiting script on Fedora
  • #240: Raise exception on IBus setup failure to enable automatic fallback
  • #234: Removed leading space from first speech transcription
  • #242/#253: Removed disconnected evdev devices to prevent CPU spin

🔧 Improvements

  • Web SEO Enhancements — Added 7 new optimized pages for organic traffic
  • Mobile Responsiveness — Improved mobile and tablet layout for the website
  • Better Fedora Support — Fixed dnf check-update behavior
  • Improved Device Handling — More robust handling of input device connections/disconnections

See the full changelog.


Quick Update

Simply re-run the installation command:

curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.7.0-beta/install.sh | bash

The installer will:

  • ✅ Detect and stop any running Vocalinux processes
  • ✅ Update your existing installation
  • ✅ Preserve your configuration and models
  • ✅ Install any new dependencies

If You Installed from Source

cd vocalinux
git fetch origin
git checkout v0.7.0-beta
./install.sh

Or to get the latest development version:

cd vocalinux
git pull origin main
./install.sh

Checking Your Current Version

python3 -c "import vocalinux; print(vocalinux.version.__version__)"

Troubleshooting

Update Issues?

If your update doesn't go smoothly, try a clean reinstall:

# Uninstall (keeps your config and models by default)
./uninstall.sh --keep-config --keep-data

# Or uninstall completely
./uninstall.sh

# Reinstall fresh
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.7.0-beta/install.sh | bash

Old Version Still Running

# Kill any running instances
pkill -f vocalinux

# Start fresh
vocalinux

Missing Dependencies

If you see dependency errors:

# Ubuntu/Debian
sudo apt update
sudo apt install -y python3-gi python3-gi-cairo gir1.2-gtk-3.0

# Fedora
sudo dnf install -y python3-gobject gtk3

# Arch
sudo pacman -S python-gobject gtk3

Need Help?