xavierk/voculinux
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

chore(release): prepare v0.6.3-beta (#235)

Browse Source 
* 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
This commit is contained in:
Jatin K Malik
2026-02-18 23:07:00 -08:00
committed by GitHub
parent ca6ba56318
commit d7d91a7db2
7 changed files with 53 additions and 174 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+9 -9
View File
@@ -28,11 +28,11 @@
**A seamless free open-source private voice dictation system for Linux**, comparable to built-in solutions on macOS and Windows.
## 📚 What's New in v0.6.2-beta
## 📚 What's New in v0.6.3-beta
> 🎉 **Beta Release with whisper.cpp!** — Fast, private, offline voice dictation for Linux.
### 🚀 Highlights (v0.6.0 → v0.6.2)
### 🚀 Highlights (v0.6.0 → v0.6.3)
| Feature | Description |
|---------|-------------|
@@ -41,13 +41,13 @@
| **📦 Interactive Installer** | Choose between 3 engines with hardware auto-detection |
| **🔧 Multi-Distro Support** | Works on Ubuntu, Debian, Fedora, Arch, and more |
### ✨ New Features (v0.6.2)
### ✨ New Features (v0.6.3)
- **IBus Text Injection Engine** — Full Wayland support via IBus input method
- **X11 IBus Support** — Extended IBus support to X11 for non-US keyboard layouts
- **Thread-Safe Model Access** — Improved stability with concurrent model operations
### 🐛 Bug Fixes (v0.6.2)
### 🐛 Bug Fixes (v0.6.3)
- **#229**: Fixed `[BLANK_AUDIO]` token suppression in whisper.cpp output
- **#228**: Removed premature pkg-config check in installer
@@ -120,7 +120,7 @@ Here are some screenshots showcasing Vocalinux in action:
Our new interactive installer guides you through setup with intelligent hardware detection:
```bash
curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.2-beta/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh
curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.3-beta/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh
```
**Choose your engine:**
@@ -134,25 +134,25 @@ The installer will:
- **Download the appropriate model** (~39MB for whisper.cpp tiny)
- **Install in ~1-2 minutes** (vs 5-10 min with old Whisper)
> **Note**: Installs v0.6.2-beta. For other versions, check [GitHub Releases](https://github.com/jatinkrmalik/vocalinux/releases).
> **Note**: Installs v0.6.3-beta. For other versions, check [GitHub Releases](https://github.com/jatinkrmalik/vocalinux/releases).
### Installation Options
**Default (whisper.cpp - recommended):**
```bash
curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.2-beta/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh
curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.3-beta/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh
```
Fastest installation (~1-2 min), universal GPU support via Vulkan.
**Whisper (OpenAI) - if you prefer PyTorch:**
```bash
curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.2-beta/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh --engine=whisper
curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.3-beta/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh --engine=whisper
```
NVIDIA GPU only (~5-10 min, downloads PyTorch + CUDA).
**VOSK only - for low-RAM systems:**
```bash
curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.2-beta/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh --engine=vosk
curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.3-beta/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh --engine=vosk
```
Lightweight option (~40MB), works on systems with 4GB RAM.
docs/INSTALL.md
+3 -3
View File
@@ -7,10 +7,10 @@ This guide provides detailed instructions for installing Vocalinux on Linux syst
### One-liner Installation (Recommended)
```bash
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.2-beta/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.3-beta/install.sh | bash
```
> **Note**: Installs v0.6.2-beta with **whisper.cpp** (our new default engine). For other versions, check [GitHub Releases](https://github.com/jatinkrmalik/vocalinux/releases).
> **Note**: Installs v0.6.3-beta with **whisper.cpp** (our new default engine). For other versions, check [GitHub Releases](https://github.com/jatinkrmalik/vocalinux/releases).
That's it! The installer handles everything automatically:
- ✅ Installs whisper.cpp (~1-2 minutes, no heavy dependencies!)
@@ -495,7 +495,7 @@ Already have Vocalinux installed? See the [Update Guide](UPDATE.md) for instruct
Quick update command:
```bash
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.2-beta/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.3-beta/install.sh | bash
```
## Getting Help
docs/UPDATE.md
+33 -154
View File
@@ -2,69 +2,52 @@
This guide explains how to update Vocalinux to the latest version.
## What's New in v0.6.2-beta
## What's New in v0.6.3-beta
### 🐛 Bug Fixes
- **Fixed #221**: Add missing `psutil` dependency - Fresh installs now work correctly (pywhispercpp requires psutil internally)
- **Fixed #219**: Suppress `[BLANK_AUDIO]` tokens in whisper.cpp output - Cleaner transcription results
- **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
- **Better Multi-Distro Installation** - Improved Vulkan shader package detection and installation for Ubuntu, Debian, Fedora, Arch, and more
- **CI Improvements** - Fixed nightly build tag cleanup and older release deletion
- **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](https://github.com/jatinkrmalik/vocalinux/releases/tag/v0.6.2-beta).
See the [full changelog](https://github.com/jatinkrmalik/vocalinux/releases/tag/v0.6.3-beta).
---
## Previous Versions
## Quick Update
### v0.6.2-beta
### If You Installed via curl (Recommended)
- **Interactive Backend Selection**: Choose between GPU (Vulkan/CUDA) or CPU backend
- **Enhanced Welcome Message**: Redesigned end-of-installation experience
- **Simplified Install Commands**: No more `--tag` parameter needed
- **Better GPU Support**: Fixed Vulkan development library detection
### v0.6.0-beta
- **whisper.cpp as default engine**: Fast, works with any GPU via Vulkan
- **Multi-language support**: Auto-detect language with manual override
- **System tray indicator**: Better desktop integration
- **Wayland support**: Full compatibility with modern Linux desktops
---
## Quick Update (Recommended)
### If You Installed via curl (One-liner)
Simply re-run the installation command with the new version tag:
Simply re-run the installation command:
```bash
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.2-beta/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.3-beta/install.sh | bash
```
The installer will:
- Update your existing installation
- Preserve your configuration and models
- Install any new dependencies
> **Note**: The installer automatically detects and updates existing installations.
- ✅ 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
```bash
cd vocalinux
git fetch origin
git checkout v0.6.2-beta
git checkout v0.6.3-beta
./install.sh
```
Or to always get the latest main branch:
Or to get the latest development version:
```bash
cd vocalinux
@@ -74,128 +57,33 @@ git pull origin main
---
## Detailed Update Methods
### Method 1: Reinstall via Installer (Easiest)
The installer handles everything automatically:
```bash
# From the repo (if you have it cloned)
cd vocalinux
./install.sh --tag=v0.4.1-alpha
# Or via curl (for any installation)
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.2-beta/install.sh | bash
```
**What gets preserved:**
- Your configuration at `~/.config/vocalinux/`
- Your speech models at `~/.local/share/vocalinux/models/`
- Your custom settings and preferences
### Method 2: Manual Update (Advanced)
If you prefer manual control over the update process:
```bash
# 1. Navigate to your vocalinux directory
cd vocalinux
# 2. Pull the latest changes
git fetch origin
git checkout v0.6.2-beta
# 3. Activate your virtual environment
source venv/bin/activate
# 4. Update the package
pip install --upgrade .
# 5. Exit and restart
exit
vocalinux
```
---
## Checking Your Current Version
To see which version you have installed:
```bash
# Check the package version
python3 -c "import vocalinux; print(vocalinux.version.__version__)"
# Or check from the repo
git describe --tags
```
---
## What's New in v0.6.2-beta
### 🚀 Major Feature: whisper.cpp is Now Default!
This release brings **whisper.cpp** as the new default speech recognition engine—a game-changing upgrade!
**Key Improvements:**
- **⚡ 10x faster installation** — No more 2.3GB PyTorch downloads (~1-2 min vs ~5-10 min)
- **🎮 Universal GPU support** — Works with AMD, Intel, and NVIDIA via Vulkan (not just NVIDIA CUDA)
- **💾 Smaller footprint** — Tiny model is only ~39MB vs ~75MB
- **🔥 Better performance** — C++ optimized inference with true multi-threading (no Python GIL)
- **🌍 99+ languages** with automatic language detection
**Additional Improvements:**
- **Interactive installer**: Choose between 3 engines (whisper.cpp, Whisper, VOSK)
- **Hardware auto-detection**: Automatically detects your GPU and recommends optimal settings
- **Enhanced logging**: Comprehensive debug info for whisper.cpp troubleshooting
- **Better documentation**: Updated all docs to reflect whisper.cpp as the new default
See the [full changelog](https://github.com/jatinkrmalik/vocalinux/releases/tag/v0.6.2-beta).
---
## Previous Versions
### v0.4.1-alpha
- **Language selector UI**: Choose from 10 languages with auto-detection support for Whisper
- **App drawer launch fix**: Desktop entry now works when installing from local repo
- **Better commit handling**: Fixed error with special characters in commit messages
- **Improved update mechanism**: Corrected git fetch syntax for tag-based updates
### v0.4.0-alpha
- **Multi-language support**: French, German, and Russian
- **Debian 13+ compatibility**: Fixed appindicator package issues
- **Python 3.12+ support**: Improved venv handling
- **Better install script**: Tag-based version selection
---
## Troubleshooting
### Update Won't Install
### Update Issues?
**Symptom:** Installation fails during update
**Solution:** Run the uninstaller first, then reinstall:
If your update doesn't go smoothly, try a clean reinstall:
```bash
# Keep your config and models
# Uninstall (keeps your config and models by default)
./uninstall.sh --keep-config --keep-data
# Reinstall
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.2-beta/install.sh | bash
# 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
**Symptom:** After update, old version is still active
**Solution:** Fully exit and restart:
```bash
# Kill any running instances
pkill -f vocalinux
@@ -204,28 +92,20 @@ pkill -f vocalinux
vocalinux
```
### Dependencies Changed
### Missing Dependencies
**Symptom:** New version has different system dependencies
**Solution:** The installer handles this, but if you see errors:
If you see dependency errors:
```bash
# 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
## Automatic Updates (Coming Soon)
We're working on an in-app update mechanism. For now, please use the manual update methods above.
To check if a new version is available:
```bash
# Check latest release
curl -s https://api.github.com/repos/jatinkrmalik/vocalinux/releases/latest | grep "tag_name"
# Arch
sudo pacman -S python-gobject gtk3
```
---
@@ -233,6 +113,5 @@ curl -s https://api.github.com/repos/jatinkrmalik/vocalinux/releases/latest | gr
## Need Help?
- 📖 [Installation Guide](INSTALL.md)
- 📖 [User Guide](USER_GUIDE.md)
- 🐛 [Report Issues](https://github.com/jatinkrmalik/vocalinux/issues)
- 💬 [Discussions](https://github.com/jatinkrmalik/vocalinux/discussions)
install.sh
+3 -3
View File
@@ -147,7 +147,7 @@ while [[ $# -gt 0 ]]; do
echo " --test Run tests after installation"
echo " --venv-dir=PATH Specify custom virtual environment directory"
echo " --skip-models Skip downloading speech models during installation"
echo " --tag=TAG Install specific release tag (default: v0.6.1-beta)"
echo " --tag=TAG Install specific release tag (default: v0.6.3-beta)"
echo " --help Show this help message"
echo ""
echo "Examples:"
@@ -188,7 +188,7 @@ echo ""
check_running_processes
INSTALL_TAG="${INSTALL_TAG:-v0.6.1-beta}"
INSTALL_TAG="${INSTALL_TAG:-v0.6.3-beta}"
# Check if running from within the vocalinux repo or remotely (via curl)
REPO_URL="https://github.com/jatinkrmalik/vocalinux.git"
@@ -849,7 +849,7 @@ if [[ "$INTERACTIVE_MODE" == "yes" ]]; then
if [ ! -t 0 ]; then
print_error "Interactive mode requires a terminal (TTY)."
print_error "Please run from a terminal, or use automatic mode:"
print_error " curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.1-beta/install.sh | bash"
print_error " curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/v0.6.3-beta/install.sh | bash"
exit 1
fi
src/vocalinux/version.py
+2 -2
View File
@@ -2,8 +2,8 @@
Version information for Vocalinux.
"""
__version__ = "0.6.2-beta"
__version_info__ = (0, 6, 2, "beta")
__version__ = "0.6.3-beta"
__version_info__ = (0, 6, 3, "beta")
__author__ = "Jatin K Malik"
__email__ = "jatinkrmalik@gmail.com"
__license__ = "GPL-3.0"
web/package.json
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "vocalinux-website",
"version": "0.6.2",
"version": "0.6.3",
"private": true,
"type": "module",
"scripts": {
web/src/app/page.tsx
+2 -2
View File
@@ -65,7 +65,7 @@ const homeJsonLd = [
},
description:
"Offline voice dictation and speech-to-text for Linux with whisper.cpp and VOSK.",
"softwareVersion": "0.6.2-beta",
"softwareVersion": "0.6.3-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.6.2 Beta
v0.6.3 Beta
</span>
</Link>