diff --git a/README.md b/README.md index 62e273f..1720456 100644 --- a/README.md +++ b/README.md @@ -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. diff --git a/docs/INSTALL.md b/docs/INSTALL.md index 1a972dd..8e47b8e 100644 --- a/docs/INSTALL.md +++ b/docs/INSTALL.md @@ -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 diff --git a/docs/UPDATE.md b/docs/UPDATE.md index 7d01291..0f24f5c 100644 --- a/docs/UPDATE.md +++ b/docs/UPDATE.md @@ -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) diff --git a/install.sh b/install.sh index 235bec7..468ce80 100755 --- a/install.sh +++ b/install.sh @@ -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 diff --git a/src/vocalinux/version.py b/src/vocalinux/version.py index 63e54a4..829479e 100644 --- a/src/vocalinux/version.py +++ b/src/vocalinux/version.py @@ -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" diff --git a/web/package.json b/web/package.json index f6b2cd1..03ba086 100644 --- a/web/package.json +++ b/web/package.json @@ -1,6 +1,6 @@ { "name": "vocalinux-website", - "version": "0.6.2", + "version": "0.6.3", "private": true, "type": "module", "scripts": { diff --git a/web/src/app/page.tsx b/web/src/app/page.tsx index 4bd1bda..dd6d1c9 100644 --- a/web/src/app/page.tsx +++ b/web/src/app/page.tsx @@ -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() { /> Vocalinux - v0.6.2 Beta + v0.6.3 Beta