Files

T

Jatin K MalikandGitHub d7d91a7db2 chore(release): prepare v0.6.3-beta (#235 )

* chore(release): prepare v0.6.3-beta

- Fix #220: Installer default tag now points to correct version
- Update version from 0.6.2-beta to 0.6.3-beta
- Update documentation version references
- Update website schema and badges
- Add v0.6.3-beta changelog entry

The v0.6.2-beta installer was defaulting to v0.6.1-beta which is
missing the psutil dependency, causing fresh installs to fail.

* docs(update): simplify update guide, remove duplicate version history

2026-02-18 23:07:00 -08:00

2.6 KiB

Raw Blame History

Updating Vocalinux

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

What's New in v0.6.3-beta

🐛 Bug Fixes

Fixed #220: Installer default tag now points to correct version
Fixed #221: Add missing psutil dependency for fresh installs
Fixed #219: Suppress [BLANK_AUDIO] tokens in whisper.cpp output
Fixed #204: Resolve PyAudio paInt16 attribute error on audio device reconnection
Fixed #205: Ensure whisper module is properly installed with --auto flag

🔧 Improvements

Process Check & Interactive Prompts - Installer now detects and prompts to stop running Vocalinux before updating
Command Processor Fix - No more leading space on first speech transcription
Better Multi-Distro Installation - Improved Vulkan shader package detection

See the full changelog.

Quick Update

If You Installed via curl (Recommended)

Simply re-run the installation command:

curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.3-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.6.3-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.6.3-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

2.6 KiB Raw Blame History