21b4e782b58a8d4d6a4bead209e5c09aecfc2f55
31
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 jatinkrmalikandFakhareddine
|
d04947374f |
fix(recognition): preserve final speech on stop (fixes #401)
Replace hard-coded stop tail trim with configurable stop_sound_guard_ms (default 200ms) so quick key release no longer clips the final spoken word in push-to-talk mode. Co-authored-by: Fakhareddine <fe.sabbari@claranet.com> |
||
|
Jatin K MalikandGitHub
|
410f6b27d8 |
fix(tray): clarify missing GNOME AppIndicator support on Debian (#385)
* fix(tray): detect missing AppIndicator watcher on GNOME * test(tray): cover AppIndicator watcher and failure branches |
||
|
Jatin K MalikandGitHub
|
be0614010d |
refactor: systematic code quality improvements across 20 dimensions (#377)
* refactor: improve code quality across multiple dimensions Code quality improvements identified and driven by desloppify analysis: **action_handler.py** - Replace 9 repetitive shortcut forwarding methods with data-driven _SHORTCUT_ACTIONS class-level dispatch table - Add _make_shortcut_handler() factory for shortcut closures - Add explicit type annotation for action_handlers dict **config_manager.py** - Move 'import copy' from __init__ to module level (stdlib best practice) - Add _VALID_SECTIONS frozenset for section name validation in set() - Narrow broad Exception catch to (KeyError, TypeError) in set() - Add deprecation warning to save_settings() guiding toward save_config() **tray_indicator.py** - Consolidate all imports at module top level - Remove noqa E402 suppressions for mid-file imports - Move ResourceManager import alongside other local imports **recognition_manager.py** - Narrow broad 'except Exception' to 'except OSError' for audio device enumeration errors - Narrow 'except Exception' to 'except (FileNotFoundError, OSError)' for notification subprocess errors **Tests** - Update test assertions to use specific exception types matching narrowed catches (OSError, FileNotFoundError instead of Exception/RuntimeError) * refactor: improve type safety, callback contracts, and method decomposition **main.py** — Mid-level elegance - Document callback wiring contract: text_callback, action_callback, state_callback with threading context, argument types, and behavior - Add return type annotations to nested callback functions - Reorder: define callbacks before registration for readability **config_manager.py** — Type safety, error consistency - Add typed accessors: get_str(), get_bool(), get_int(), get_float(), get_optional_int() eliminating Any returns for common access patterns - Narrow load_config exception to (json.JSONDecodeError, OSError) - Narrow save_config exception to (OSError, TypeError) **recognition_manager.py** — Low-level elegance - Decompose _init_whispercpp (141 lines) into three focused methods: - _init_whispercpp: validation and download gating (35 lines) - _load_whispercpp_model: backend detection and model loading (55 lines) - _handle_gpu_fallback: GPU incompatibility recovery (40 lines) - Narrow exception catch from broad Exception to specific types **tray_indicator.py, settings_dialog.py** — Type safety - Migrate config access from untyped get() to typed get_str(), get_bool(), get_optional_int() across 8 call sites * refactor: narrow 11 more broad Exception catches to specific types Systematically replaced broad 'except Exception' with specific exception types across recognition_manager.py: - test_audio_input: (OSError, ValueError) for audio read errors - test_audio_input outer: (OSError, ValueError, RuntimeError) for unexpected - _init_whisper: (RuntimeError, OSError) for engine init failures - _transcribe_with_whisper: (RuntimeError, OSError, ValueError) for transcription - _download_whispercpp_model: (OSError, RuntimeError, ValueError) for downloads - _download_vosk_model: (OSError, RuntimeError, ValueError) for downloads - _download_whisper_model: (OSError, RuntimeError, ValueError) for downloads This brings the total narrowed exception catches to 18+ across the codebase, improving error consistency and making failure modes more predictable. * style: fix black formatting issues Auto-format with black to fix CI lint failures in recognition_manager.py, settings_dialog.py, and test_settings_shortcuts.py. * test: add coverage for typed config accessors Add TestTypedAccessors class with 15 tests covering: - get_str(): string values, defaults, non-string conversion, None handling - get_bool(): boolean values, defaults - get_int(): integer values, invalid input fallback, missing key defaults - get_float(): float values, invalid input fallback - get_optional_int(): int values, None values, missing keys, invalid input Fixes codecov/patch coverage requirement for new typed accessor methods. |
||
|
Jatin K MalikandGitHub
|
44af1703c6 |
fix(docs): point all install curl URLs to main/install.sh (#314)
The install.sh on main now dynamically resolves the latest release tag via GitHub API (merged in PR #313), so pinning to a specific release tag in install commands is no longer needed — and was causing users to run the old hardcoded installer. Update all curl install command URLs across docs, code, and website from versioned tags (v0.9.0-beta, v0.8.0-beta) to main/install.sh: - README.md (4 URLs + note text) - docs/INSTALL.md (2 URLs + note text) - docs/UPDATE.md (2 URLs) - docs/DISTRO_COMPATIBILITY.md (1 URL) - tests/distro-testing-checklist.md (1 URL) - src/vocalinux/main.py (1 URL) - web/src/app/page.tsx (remove dynamic release fetch, hardcode main) |
||
|
Jatin K MalikandGitHub
|
baeee19f17 |
chore(release): prepare v0.9.0-beta (#310)
* chore(release): prepare v0.9.0-beta - Bump version from 0.8.0-beta to 0.9.0-beta - Update README What's New section with new features and bug fixes - Update all install script URLs to v0.9.0-beta - Add v0.9.0-beta What's New section to docs/UPDATE.md - Update SECURITY.md supported versions (0.9.x supported, 0.8.x dropped) - Update website schema softwareVersion and nav badge to 0.9.0 - Update website featureList with new sound effects and clipboard features - Add v0.9.0-beta entry to changelog page - Update web/package.json version to 0.9.0 - Add v0.9.0-beta row to RELEASE_PROCESS.md version history * docs(readme): add contributors avatar grid via contrib.rocks * feat(about): add Changelog link to About dialog * Revert "feat(about): add Changelog link to About dialog" This reverts commit 15e0984f516caccb14a0609e96d5fb6870ea247e. |
||
|
Jatin K MalikandGitHub
|
8a4dbad4ee |
fix: improve Debian/pipx installation experience (#289)
* fix: improve Debian/pipx installation experience - Enhanced error messages in check_dependencies() to provide distro-specific installation commands (Ubuntu/Debian, Fedora, Arch Linux) - Added explicit pipx guidance: install system packages BEFORE pipx install - Updated error message to use gir1.2-ayatanaappindicator3-0.1 for Debian - Added comprehensive pipx installation section to DISTRO_COMPATIBILITY.md with step-by-step instructions for all major distributions * fix: add display availability check to prevent GTK crash on Debian The original PR only added documentation and improved error messages. This commit adds the actual fix for issue #288. Root cause: On some systems (especially Debian), GTK widgets can be created before the display connection is properly established, causing the crash: gtk_widget_get_scale_factor: assertion 'GTK_IS_WIDGET (widget)' failed Fix: Add check_display_available() function that verifies Gdk.Display is available before any GTK widgets are created. This provides a clear error message instead of a cryptic GTK crash. Fixes #288 |
||
|
Jatin K MalikandGitHub
|
e35bdb2f62 |
fix(dictation): remove unwanted leading space when starting new transcription (#307)
Reset last_injected_text when recognition transitions to LISTENING state, ensuring the first dictation segment in each session is not prefixed with a space. Also simplify the space-prepending logic: always add a separator space between consecutive segments (not just after punctuation), and strip incoming text as a safety net against whisper tokenizer artifacts. |
||
|
Jatin K MalikandGitHub
|
0469defae6 |
chore(release): prepare v0.8.0-beta (#280)
* chore(release): prepare v0.8.0-beta * docs(web): align release messaging with v0.8.0-beta features * docs(web): tighten homepage messaging for v0.8.0-beta |
||
|
Jatin K MalikandGitHub
|
6fc1401ae0 |
feat(commands): make voice commands optional with auto-enable for VOSK (#274)
* feat(commands): make voice commands optional with auto-enable for VOSK This implements a new voice commands feature that: - Adds 'voice_commands_enabled' config option (None=auto, True, False) - Auto-enables voice commands for VOSK engine (which needs them for punctuation) - Auto-disables for Whisper engines (which handle punctuation natively) - Adds a toggle in Settings > Recognition tab to override the default The toggle shows the current auto-detected state and allows users to enable/disable voice commands regardless of engine choice. This addresses issue #147 discussion about voice commands utility with modern Whisper models that handle punctuation well. Closes #270 (by providing an alternative solution - disabling commands) * fix(tests): add voice_commands_enabled parameter to test expectations Update test assertions to include the new voice_commands_enabled parameter that was added to SpeechRecognitionManager. * style(tests): fix black formatting in test_speech_recognition.py * fix(commands): keep voice command mode in sync on reconfigure |
||
|
Jatin K MalikandGitHub
|
cb9b66adf3 |
fix: resolve text injection issues from issue #34 (#261)
* fix(text_injection): re-check for better tools after xdotool fallback When wtype fails due to compositor not supporting virtual keyboard protocol, the code switches to xdotool permanently. This prevents using ydotool even if its daemon is started later. This fix adds _try_recover_from_fallback() method that checks for better tools (ydotool with running daemon, or wtype with compositor support) on each text injection attempt when in fallback mode. Fixes issue #34 comment 3 (logs show xdotool but ydotool works) * feat(main): auto-start IBus daemon on Vocalinux launch This resolves the IBus autostart issue mentioned in issue #34. When Vocalinux starts, it now automatically starts the IBus daemon if: - IBus is installed on the system - IBus daemon is not already running This removes the need for users to manually configure IBus autostart on desktop environments where it doesn't start automatically (e.g., some KDE Plasma installations or minimal window managers). Changes: - Add start_ibus_daemon() function in ibus_engine.py - Call start_ibus_daemon() in main() after logging is initialized - Export start_ibus_daemon in text_injection/__init__.py |
||
|
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. |
||
|
Jatin K MalikandGitHub
|
b0565b36ad |
fix: prevent multiple instances from running simultaneously (#245)
* fix: prevent multiple instances from running simultaneously Add single-instance enforcement using file locking to prevent duplicate instances when auto-start is enabled on boot (issue #244). Changes: - Add single_instance.py module with fcntl-based file locking - Check for existing instance early in main() before any initialization - Register atexit handler to release lock on normal exit - Lock file located at ~/.local/share/vocalinux/instance.lock If another instance is already running, the app exits gracefully with a helpful error message telling the user how to resolve the situation. * fix: add GTK notification when duplicate instance detected Show a system notification to the user when another instance is already running, in addition to the existing stderr/log output. Changes: - Import Notify from gi.repository when duplicate instance detected - Show notification with error icon and message - Give notification time to display before exiting (0.5s sleep) - Fallback to silent exit if notification fails (e.g., headless) |
||
|
Jatin K MalikandGitHub
|
9886e8cb9d |
feat(ui): add auto-start on boot support (#207)
* feat(ui): add auto-start on boot support - Add --start-minimized CLI flag for autostart entry - Create autostart_manager.py to handle XDG autostart desktop entry - Add autostart config option in config_manager.py - Add Start on Login toggle in Settings dialog - Add Start Minimized toggle in Settings dialog - Add Start on Login checkbox in system tray menu - Add first-run dialog to ask about autostart preference Closes #184 * fix(test): add first_run: False to mock config settings The tests were failing with StopIteration because main() now checks for first_run and shows a dialog if True. By setting first_run: False in the mock config, we skip the first-run dialog code path. * fix(ui): harden autostart behavior across Linux sessions Use XDG-compliant autostart paths and robust Exec command resolution, keep first-run prompt semantics correct, and fix GTK toggle handling so state changes are applied reliably. * docs(autostart): document XDG startup model and limits Clarify that Vocalinux uses desktop-session XDG autostart, not systemd services, and explain compatibility expectations for mainstream DEs versus minimal/custom WM sessions. * feat(ui): add first-run quick-start guidance text Expand the welcome dialog with concise first-time usage guidance and clear direction to the tray menu Settings entry while preserving the existing autostart decision flow. * fix(uninstall): remove XDG autostart desktop entry Ensure uninstall removes ~/.config autostart registration and reports leftover autostart entries during verification. * fix(install): ignore defunct processes in running-check Filter installer process detection to exclude defunct entries and installer/uninstaller shells so stale zombie rows do not block reinstall. * fix(uninstall): ignore defunct processes in running-check Use filtered process detection so zombie entries and installer shells do not trigger false running-process warnings during uninstall. |
||
|
Jatin K MalikandGitHub
|
1e0a2a6cee |
chore(release): prepare v0.6.1-beta (#201)
Bump version from 0.6.0-beta to 0.6.1-beta with installation improvements: Version Updates: - src/vocalinux/version.py: 0.6.0-beta → 0.6.1-beta - install.sh: Default tag and help text updated - web/package.json: 0.6.0 → 0.6.1 - web/src/app/layout.tsx: schema.org softwareVersion updated - web/src/app/page.tsx: version badge updated Documentation Updates: - README.md: New 'What's New' section for v0.6.1-beta - docs/UPDATE.md: Added v0.6.1-beta release notes with new features - docs/INSTALL.md: Version references updated - docs/RELEASE_PROCESS.md: Example commands updated - tests/distro-testing-checklist.md: Version references updated - src/vocalinux/main.py: Error message updated New Features in v0.6.1-beta: - Interactive backend selection for whisper.cpp (GPU vs CPU) - Enhanced welcome message with testing instructions - Simplified install commands (tag-based URLs) - Better GPU support with proper library detection Bug Fixes: - Fixed bash arithmetic with set -e - Fixed TTY detection for interactive mode - Auto-install git if missing - Fixed GPU installation commands |
||
|
Jatin K MalikandGitHub
|
86ee79cc0d |
chore: update install commands to use tag-based URLs (#200)
Changed install commands to download install.sh directly from the release tag instead of from main branch with --tag parameter. This ensures: 1. The install script version matches the release being installed 2. No version mismatch between script and code 3. Simpler, cleaner install commands Changes: - install.sh: Updated error message to use v0.6.0-beta URL - README.md: All install commands now use v0.6.0-beta/install.sh - docs/INSTALL.md: Updated quick install command - docs/UPDATE.md: Updated update command examples - docs/RELEASE_PROCESS.md: Updated example command - src/vocalinux/main.py: Updated error message install command - tests/distro-testing-checklist.md: Updated download URL - web/src/app/page.tsx: Now uses dynamic tag in URL (not main) - .github/workflows/release.yml: Release notes use tag-based URL Before: curl .../main/install.sh | bash -s -- --tag=v0.6.0-beta After: curl .../v0.6.0-beta/install.sh | bash Fixes version consistency between install script and installed code. |
||
|
Jatin K MalikandGitHub
|
57a0ddd0b8 |
feat(speech): add whisper.cpp with Vulkan support for GPU acceleration (#179)
* feat(speech): add whisper.cpp with Vulkan support for GPU acceleration Add whisper.cpp as a new speech recognition engine with the following features: - Vulkan GPU acceleration support (AMD, Intel, NVIDIA) - Fallback to CUDA for NVIDIA GPUs - CPU-only mode with automatic thread optimization - Support for all model sizes: tiny, base, small, medium, large - Hardware detection to recommend best model/backend - Models downloaded from Hugging Face (ggml format) - Updated UI to show compute backend info in settings - pywhispercpp as the Python binding library - whisper_cpp as the new default engine Changes: - New whispercpp_model_info.py with model metadata and hardware detection - Updated recognition_manager.py with whisper.cpp init and transcription - Updated settings_dialog.py with whisper.cpp UI support - Updated config_manager.py with whisper_cpp_model_size config - Updated main.py with whisper_cpp CLI option - Updated pyproject.toml with pywhispercpp dependency - Updated install.sh with vulkan-tools for GPU detection Closes #104 * style: fix black and isort formatting issues * test: update config manager test for whisper_cpp default engine * feat(install): interactive mode with 3 engine choices and whisper.cpp as default Major changes to install.sh: - Interactive mode is now the DEFAULT (not --auto) - Added --auto flag for non-interactive automatic installation - New --engine flag to specify engine directly - Interactive mode shows 3 engine options with visual boxes: 1. whisper.cpp (recommended) - Vulkan/CUDA/CPU support 2. whisper (OpenAI) - PyTorch-based, NVIDIA-only 3. VOSK - lightweight option - Hardware detection with recommendations: - Detects Vulkan support (AMD/Intel/NVIDIA) - Detects NVIDIA CUDA - Checks available RAM - Recommends best engine based on hardware - Updated help text with new options and examples - Removed old --with-whisper, --whisper-cpu, --no-whisper flags - whisper.cpp is now the default engine for automatic mode * feat(uninstall): kill running vocalinux processes before uninstall * fix(whisper.cpp): auto-download model, use all CPU cores, hide unavailable engines Three fixes for whisper.cpp implementation: 1. Auto-download model during install - Added install_whispercpp_model() function to install.sh - Downloads ggml-tiny.bin (~39MB) from Hugging Face - Runs automatically when whisper.cpp engine is selected 2. Use all CPU cores for transcription - Added n_threads parameter to Model initialization - Uses multiprocessing.cpu_count() to get all cores - Significantly improves transcription speed 3. Hide unavailable engines from dropdown - Added get_available_engines() function to detect installed engines - Settings dialog now only shows engines that are actually installed - Falls back to first available engine if current not available Fixes user-reported issues with whisper.cpp integration. * ui(settings): display whisper.cpp correctly and increase dialog height - Changed engine display name from 'whisper_cpp' to 'whisper.cpp' - Added format_engine_display_name() helper function - Dialog now uses 75% of screen height for better visibility - More options visible by default without scrolling * revert(settings): remove display name change, keep dialog height increase - Reverted engine display name change (was breaking engine selection) - Kept dialog height at 75% of screen for better visibility * style: fix black and isort formatting for whisper.cpp logging * style: fix black formatting in settings_dialog.py * ci: fix Fedora 39 container package installation Add dnf cache update and fallback with --nogpgcheck for Fedora containers that may have stale or missing package metadata. |
||
|
Jatin K MalikandGitHub
|
fdf1de5180 |
fix(transcription): add space after punctuation when transcribing again (#151)
When transcribing text continuously (stop and start again), the new text was being injected immediately after the last character without a space. This caused issues like "Hello world.This is a test" instead of "Hello world. This is a test". Fix: - Check if the last injected text ends with punctuation or other characters that typically need a space after them (., ,, !, ?, ;, :, quotes, etc.) - If yes, add a space before injecting the new text - Log when space is added for debugging Characters requiring space: - Punctuation: . , ! ? ; : ) ] } - _ - Quotes: " ' Closes #151 |
||
|
|
94f71853e0 |
reliability: Microphone Reconnection and Audio Buffer Limits (#109)
* fix: implement microphone reconnection and audio buffer limits for reliability - Add microphone reconnection logic with exponential backoff - Implement audio buffer limits to prevent memory issues - Add configurable buffer size limits with clamping - Improve error handling for audio device failures - Add buffer statistics and monitoring capabilities - Graceful stream cleanup and resource management Resolves #92 Changes made: - Added _max_buffer_size, _reconnection_attempts, _max_reconnection_attempts attributes - Implemented _attempt_audio_reconnection() method with exponential backoff - Enhanced _record_audio() method with buffer limit checking and reconnection - Added set_buffer_limit() and get_buffer_stats() methods - Improved error handling for IOError/OSError during audio recording - Added test scripts to validate reliability improvements The implementation prevents memory issues by limiting audio buffer size and automatically reconnecting to audio devices when they fail, with proper exponential backoff to prevent rapid reconnection attempts. * fix: Address code review feedback for PR #109 - Add thread lock (_buffer_lock) for audio_buffer to prevent race conditions - Fix _last_audio_error_time reset in cleanup - Protect buffer access in stop_recognition and get_buffer_stats with lock - Fix test_max_reconnection_attempts to match actual counter behavior Addresses review feedback for microphone reconnection and audio buffer limits * style: fix lint errors * fix: add missing sys import in audio_feedback.py - Add sys import required by _is_ci_mode() function - Remove temporary test_reliability scripts * style: fix black formatting --------- Co-authored-by: OpenClaw Reviewer <review@openclaw.ai> |
||
|
|
be928332c5 |
fix: Debian dependencies and AppIndicator fallback (#123)
* fix: Debian dependencies in install.sh Fixes issue #102: Building on a fresh Debian installation in a VM with GNOME required additional dependencies for pip to install. pip fails with Meson submodule failing without cairo and girepository-2.0 development packages. Changes: - install.sh: Separated Debian packages from Ubuntu packages; selects Debian if found; otherwise same workflow for apt packages - docs/INSTALL.md: Separated Debian installation instructions from Ubuntu, updated package list. - src/vocalinux/main.py: Fixed comment indicating gir1.2-ayatana-appindicator3 is only for Debian 13- it's for Debian 11+ - CONTRIBUTING.md: Separated Debian installation instructions from Ubuntu, updated package list. * fix: fall back to Ayatana AppIndicator --------- Co-authored-by: Tanjera <ibi.keller@gmail.com> |
||
|
Jatin K MalikandGitHub
|
c9810dc7f5 |
fix: Lazy GTK imports for better pip/pipx compatibility (#49)
* fix: Lazy GTK imports for better pip/pipx compatibility - Move GTK-dependent imports (tray_indicator) inside main() function - Import after check_dependencies() so users get helpful error messages - Update ui/__init__.py to not import tray_indicator at module level - Update vocalinux/__init__.py to not import GTK-dependent modules - Improved error messages for pip/pipx users with missing GTK typelibs - Bump version to 0.2.1-alpha This fixes the 'Namespace AppIndicator3 not available' error that pip/pipx users encounter because PyGObject can't find system typelibs. Closes #47 * test: simplify settings dialog tests * style: fix lazy import ordering |
||
|
Ibi KellerandGitHub
|
4219e3e398 |
fix: Typo in gir1.2-ayatanaappindicator3-0.1 .deb package (Debian 13) (#101)
There was a typo in the gir1.2-ayatanaappindicator3-0.1 .deb package referred to in apt commands, submitted in commit 27ebbfe417f178eaabcf2ac10af63f37bc819fac gir1.2-ayatana-appindicator3 (typo) replaced with gir1.2-ayatanaappindicator3-0.1 per Debian package list at https://packages.debian.org/search?keywords=gir1.2-ayatanaappindicator3-0.1 Will be backwards compatible with Debian 11 (bullseye), 12 (bookworm), and current 13 (trixie). Changes: - install.sh: gir1.2-ayatana-appindicator3 (typo) replaced with gir1.2-ayatanaappindicator3-0.1 - docs/INSTALL.md: gir1.2-ayatana-appindicator3 (typo) replaced with gir1.2-ayatanaappindicator3-0.1 - src/vocalinux/main.py: gir1.2-ayatana-appindicator3 (typo) replaced with gir1.2-ayatanaappindicator3-0.1 - CONTRIBUTING.md: gir1.2-ayatana-appindicator3 (typo) replaced with gir1.2-ayatanaappindicator3-0.1 |
||
|
|
ad84fd882a |
feat: add language selector UI with auto-detection support (#87)
* feat: add language selector UI with auto-detection support This commit implements a comprehensive language selector for the GUI, extending support from 4 to 10 languages and adding Whisper auto-detect. Changes: - Add SUPPORTED_LANGUAGES constant with 10 languages (auto, en-us, hi, es, fr, de, it, pt, ru, zh) - Each language includes display name, Whisper code, VOSK model name, and optional warning - Extend VOSK_MODEL_INFO to include Hindi, Spanish, Italian, Portuguese, and Chinese models - Add language dropdown in Settings dialog with status indicators (✓ downloaded, ↓ needs download, ⚠ warning) - Add language warning label for auto-detect and engine compatibility messages - Update default language from "en-us" to "auto" for Whisper auto-detection - Handle "auto" language in Whisper (passes None for auto-detect) - Handle "auto" language in VOSK (falls back to "en-us" since VOSK doesn't support auto-detect) - Update CLI --language argument to include all supported languages Fixes the issue where Hindi speech was being transcribed as English because the language was hardcoded to "en-us" which Whisper interpreted as "force English transcription" rather than auto-detect. Related PRs: - #72 - Feature: Add language auto-detection and GUI selector (supersedes) - #71 - Feature: Add multi-language support for FR, DE, RU (builds upon) - #52 - Feature: 3 more languages for Whisper and VOSK (extends) - #68 - Comment out language parameter in transcribe call (addresses) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * style: format main.py with black * fix: use venv python and set GI_TYPELIB_PATH for verification * fix: create wrapper scripts that set GI_TYPELIB_PATH Problem: The symlinks in ~/.local/bin pointed to venv scripts that failed because PyGObject couldn't find the system typelib files (AppIndicator3 namespace not available). Solution: Create wrapper scripts in ~/.local/bin that: 1. Set GI_TYPELIB_PATH=/usr/lib/girepository-1.0 2. Execute the venv's vocalinux scripts This fixes the issue where vocalinux-gui would fail to start with: ValueError: Namespace AppIndicator3 not available * fix: set GI_TYPELIB_PATH in desktop entry Exec line When launching from the app drawer, the environment variables from the wrapper script weren't being inherited properly. By adding GI_TYPELIB_PATH directly in the desktop entry's Exec line, the app can now find the AppIndicator3 typelib files. * fix: always create wrapper scripts, not just for remote installs The wrapper scripts were only created when CLEANUP_ON_EXIT=yes, which is only set for remote (curl-based) installations. When running from a local repository, the wrapper scripts were never created, causing the desktop entry and launch commands to fail. * fix: prevent recursion in LoggingHandler when processing log records The custom LoggingHandler was triggering logging from within the logging system itself, causing infinite recursion when formatting log records. This could happen when the logging formatter or any operation during record processing triggered additional log messages. Fix: Add _emitting flag to prevent recursive calls to emit(). * fix: prevent infinite loop in settings dialog when changing language Add guard flags to prevent recursive event handler calls: - _populating_models: blocks _on_model_changed during model population - _processing_language_change: blocks recursive language change handling - _applying_settings: blocks recursive settings application These guards prevent the infinite loop that occurred when selecting a language whose VOSK model wasn't downloaded yet. Fixes issue where "Model small needs download" logged repeatedly. * fix: handle language parameter in reconfigure and improve UX - Fix reconfigure() to properly handle language parameter changes - Remove _processing_language_change check from _auto_apply_settings to allow settings to be applied when language changes - Hide unsupported languages in dropdown based on selected engine * VOSK: only show languages with available models (no "auto") * Whisper: show all supported languages including "auto" - Remove duplicate _auto_apply_settings call in _on_engine_changed - Set active language in combo after repopulating options This fixes: 1. Whisper continuing to use old language after switching (e.g., still transcribing in Hindi after switching to en-us) 2. Potential infinite loop when selecting languages for VOSK 3. User confusion by showing incompatible language options --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com> |
||
|
|
68cb35f5b3 |
Fix: Handle deprecated appindicator package on Debian 13+ (#70)
* Fix: Handle deprecated appindicator package on Debian 13+ Fixes #69 The gir1.2-appindicator3-0.1 package was deprecated in Debian 13 (trixie) and replaced with gir1.2-ayatana-appindicator3. This change adds fallback logic to try the new package if the old one is not available. Changes: - install.sh: Try old package first, fall back to ayatana-appindicator - docs/INSTALL.md: Document both package options - src/vocalinux/main.py: Update error message with Debian 13+ note - CONTRIBUTING.md: Update dev setup instructions Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * fix: clean up whitespace in filtered package list --------- Co-authored-by: Claude Opus <noreply@anthropic.com> |
||
|
|
1172a0e54b |
Feature: Add multi-language support for FR, DE, RU
Add support for French, German, and Russian languages in both VOSK and Whisper engines. - Adds language configuration to config system - Adds --language command-line argument - Creates vosk_model_info.py utility for model mapping - Supports en-us, fr, de, ru languages - Merged with latest main including PR #70 (Debian 13+ appindicator fix) Co-Authored-by: Artem Lytvynov <violog@users.noreply.github.com> |
||
|
Jatin K MalikandGitHub
|
7a6d0d4e2b |
feat: flexible Whisper installation options for different system configurations (#63)
* fix: VOSK-only install and CLI arg handling for low-memory systems Fixes several issues reported by users on low-memory systems (8GB RAM): 1. Install script: Don't auto-install Whisper in non-interactive mode - Previously, running 'curl | bash' would install Whisper by default - Now requires explicit --with-whisper flag to install Whisper - Prevents OOM errors on systems with limited RAM 2. CLI arguments: Command-line flags now properly override saved config - --engine vosk now works even if config file has whisper set - --model flag also properly overrides saved model setting - Checks sys.argv to detect if user explicitly provided arguments 3. Default engine: Changed from 'whisper' to 'vosk' - VOSK works on low-memory systems without OOM issues - Users can still install and use Whisper with --with-whisper flag - Existing configs with 'whisper' engine are still respected Reported issues: - OOM during installation on 8GB RAM system - vocalinux --engine vosk being ignored - Config file not respected when trying to force VOSK * fix: keep whisper as default engine, improve test robustness - Reverted default engine back to 'whisper' for better accuracy - Install script still defaults to VOSK-only install (--with-whisper for Whisper) - CLI args still properly override saved config - Improved test_config_manager tests to handle module caching issues * fix: default to Whisper install, --no-whisper for VOSK-only on low-RAM systems Updated install behavior: - Default (curl|bash): Installs Whisper for best experience - --no-whisper flag: Skips Whisper AND creates config with VOSK as default engine This allows low-RAM users (8GB) to run: curl -fsSL .../install.sh | bash -s -- --no-whisper Which will: 1. Skip installing torch/whisper (avoids OOM) 2. Create ~/.config/vocalinux/config.json with engine='vosk' 3. App will use VOSK by default without needing CLI flags * docs: clarify --no-whisper is for low-RAM systems (8GB or less) Updated README and website to explain that --no-whisper flag: - Is intended for systems with 8GB RAM or less - Avoids out-of-memory errors during installation - Configures VOSK as the default speech recognition engine * feat: add --whisper-cpu flag for CPU-only PyTorch installation New installation option for users without NVIDIA GPU or with limited RAM: Install script changes: - Added --whisper-cpu flag: Installs CPU-only PyTorch (~200MB vs ~2.3GB) - Uses https://download.pytorch.org/whl/cpu index for smaller torch package - Interactive mode now offers 3 options: GPU, CPU-only, or skip Whisper - Updated help text to explain all Whisper installation options Documentation updates: - README: Added --whisper-cpu example with explanation - Website: Added new 'Whisper CPU-only' install option section Installation options summary: - Default (curl|bash): Whisper + GPU/CUDA support (~2.3GB, 5-10 min) - --whisper-cpu: Whisper + CPU-only PyTorch (~200MB, 3-4 min) - --no-whisper: VOSK only, no Whisper (~2-3 min) |
||
|
Jatin K MalikandGitHub
|
b5e1d61d17 |
Fix: Audio detection issues - Add device selection and testing (#55)
* Fix audio detection issues (#34) This commit addresses the audio detection issues reported in GitHub issue #34 where users on various Linux distributions (Fedora, Ubuntu with Wayland) were unable to get voice recognition working despite their microphones functioning in other applications. Changes: - Add audio input device enumeration and selection - New get_audio_input_devices() function lists all available input devices - Users can now select which microphone to use in Settings - Add audio diagnostics and testing - New test_audio_input() function for testing microphone input - Test Mic button in Settings to verify audio is being captured - Audio level bar shows real-time input levels - Improve audio debugging/logging - Log available audio devices on startup - Log which device is being used - Periodic audio level logging during recording - Warning when no speech detected and max level is very low - Log when speech is first detected with threshold info - Add audio device configuration - Audio device selection persisted to config file - Device loaded on startup from saved config - Better error handling - Graceful handling of audio stream open failures - Clear error messages when audio devices are unavailable The root cause for many users was that PyAudio's default device selection may not match the system's default input, especially on systems using PipeWire or complex audio routing. Users can now explicitly select their microphone and test it before using voice recognition. * Fix circular import in speech_recognition module Move lazy imports for get_audio_input_devices and test_audio_input to avoid circular dependency when settings_dialog imports from speech_recognition at module load time. * Fix audio detection issues with device selection - Add audio device enumeration and selection in Settings - Add microphone test button with audio level indicator - Improve VAD logging with periodic audio level output - Add warning when no speech detected with low audio levels - Store audio device preference in config Fixes #34 * Fix linting issues - remove unused imports, fix module-level imports, format code * Fix remaining linting issues - add type hints back, fix whitespace, add noqa comments * Fix final linting issue - break long line in config_manager * Fix formatting - use black formatting, align flake8 line-length with black (100) * Fix CI test failures: Update mocks and assertions * Fix audio feedback mock tests for CI - Move audio feedback imports to top of recognition_manager.py (remove lazy imports) - Add shared mock_audio_feedback in conftest.py for consistent mocking across tests - Update test_recognition_manager.py and test_speech_recognition.py to use shared mock - Fixes test_start_stop_recognition, test_start_recognition, test_stop_recognition |
||
|
Jatin K MalikandGitHub
|
1dc1d44665 |
feat: Alpha Launch v0.2.0 - Complete UX Overhaul 🚀🎤 (#39)
* feat: prepare for v0.2.0-alpha release * feat: prepare for v0.2.0-alpha release * chore: remove CHANGELOG.md, use GitHub Releases instead * refactor: use existing About dialog instead of Settings section * style: enhance About dialog UI readability * style: fix formatting with black and isort * feat: show VAD and silence timeout settings for Whisper engine - Renamed 'VOSK Settings' to 'Recognition Settings' - VAD Sensitivity and Silence Timeout now apply to both engines - Added tooltips explaining each setting - VOSK-specific model info only shown when VOSK selected * fix: resolve overlapping UI elements in settings dialog * fix: save VAD and silence timeout settings for both engines Previously these settings were only saved when VOSK was selected. Now they persist correctly for Whisper as well. * fix: show download progress when selecting undownloaded model Previously when auto-applying settings, models would download silently in the background without showing the progress dialog. Now: - Download progress dialog appears for undownloaded models - Model icons update correctly after download completes * feat: add download progress, speed, ETA and cancel button - Show real download progress percentage for VOSK models - Display download speed (MB/s) and estimated time remaining - Add Cancel button to abort downloads - Update status during extraction phase - Whisper downloads still pulse (uses internal downloader) * fix: defer model download until needed, don't block startup - App now starts instantly even if models aren't downloaded - Models are downloaded on-demand when selected in Settings - If user tries to dictate without a model, plays error sound - Added model_ready property to check if engine is usable * fix: improve first-run UX without downloaded models - Settings dialog now defaults to smallest available model, not saved config - Only show saved model if it's actually downloaded - Add desktop notification when trying to dictate without a model - Prevents auto-downloading large models on first launch * feat: add download progress tracking for Whisper models - Implement custom Whisper model download with progress/speed/ETA - Uses OpenAI's CDN URLs directly instead of whisper.load_model() - Progress callback works the same as VOSK downloads - Supports cancellation during download * fix: enable download progress callback for Whisper models Progress callback was only being set for VOSK downloads, not Whisper. Now both engines show real-time progress, speed, and ETA. * fix: update tests for defer_download and config manager mocking - test_main: Mock ConfigManager to prevent saved config from overriding test values - test_settings_dialog: Mock ModelDownloadDialog to prevent GTK init errors - test_speech_recognition: Use proper MockVoskModule class instead of MagicMock, pass defer_download=False for download test - test_whisper_support: Pass defer_download=False to trigger model loading in test * fix: resolve test failures for CI - test_main: Fix ConfigManager patch path to use source module - test_settings_dialog: Mock _is_vosk_model_downloaded and _is_whisper_model_downloaded to skip download flow, add missing dialog attributes - test_speech_recognition: Replace recognizer with properly configured mock that returns valid JSON, fixing test isolation issues when running all tests together * fix: mock _download_whisper_model in whisper test to avoid requests exception handling issue * fix: add gir1.2-girepository-2.0 dep for PyGObject on Ubuntu 24.04 - Add missing girepository-2.0 package for newer Ubuntu runners - Use --no-build-isolation for PyGObject to use system packages * fix: skip PyGObject pip install, use system python3-gi package - Use --no-deps for editable install to skip PyGObject - Install other deps explicitly without PyGObject - Add python3-gi-cairo for complete GTK support - Removes problematic girepository-2.0 build requirement * fix: install PyGObject via pip with proper build deps - Remove python3-gi/python3-gi-cairo (doesn't work with setup-python) - Install PyGObject from pip after installing build dependencies - Simplify venv setup without --system-site-packages hack * Fix GObject * fix: set GI_TYPELIB_PATH for pip-installed PyGObject to find AppIndicator3 |
||
|
Jatin K MalikandGitHub
|
917510d3f4 |
feat: Enhance Whisper Support & Improve Settings UI (#38)
* feat: Implement comprehensive Whisper speech recognition support 🎯 Complete Whisper Implementation: - Proper model size validation and mapping (small->base, medium->small, large->medium) - GPU/CPU device detection and automatic model placement - Efficient in-memory audio processing (no temporary files) - Custom model cache directory for organized storage - Enhanced error handling with detailed logging - Optimized transcription parameters for better accuracy 🔧 Technical Improvements: - Replace temporary file approach with direct tensor processing - Add torch.no_grad() context for efficient inference - Implement proper audio normalization and padding - Add comprehensive error handling and recovery - Support for both CPU and CUDA acceleration 📦 Installation Integration: - Add --with-whisper flag to installation script - Update setup.py with correct openai-whisper dependencies - Include torch and torchaudio in whisper extras - Automatic and manual installation options 🧪 Testing & Validation: - Add comprehensive test suite for Whisper functionality - Test model size mapping, initialization, and transcription - Mock-based testing for environments without Whisper installed - Integration with existing test infrastructure 💡 Performance Optimizations: - Efficient audio buffer processing without file I/O - GPU acceleration when available - Optimized Whisper parameters for real-time usage - Memory-efficient model loading and caching 🔄 Backward Compatibility: - Maintains full compatibility with existing VOSK implementation - Graceful fallback when Whisper dependencies are missing - No breaking changes to existing API This implementation provides a production-ready Whisper integration that significantly improves transcription accuracy while maintaining the performance characteristics needed for real-time voice dictation. * feat: Add comprehensive Whisper installation support and error handling 🎯 Enhanced User Experience: - Add intelligent Whisper import error detection in settings dialog - Show helpful installation instructions when Whisper is missing - Automatically revert to VOSK when Whisper selection fails - Provide multiple installation methods and troubleshooting tips 📋 New Installation Helper: - Create install-whisper.sh script for dedicated Whisper installation - Support multiple installation methods (standard, trusted hosts, break-system-packages) - Comprehensive error handling and fallback options - Clear instructions for SSL issues and alternative approaches 🔧 Improved Error Handling: - Detect Whisper import errors specifically in settings dialog - Show user-friendly dialog with installation instructions - Graceful fallback to VOSK when Whisper unavailable - Detailed logging for troubleshooting 💡 User Guidance: - Step-by-step installation instructions in error dialog - Multiple installation options for different environments - Clear explanation of disk space and time requirements - Troubleshooting tips for common SSL issues 🛠️ Technical Features: - Automatic virtual environment detection - Installation verification and model listing - SSL issue detection and workarounds - Comprehensive error reporting and recovery This addresses the immediate issue where users get cryptic errors when trying to use Whisper without proper installation, providing clear guidance and multiple solutions for different scenarios. * feat: Enhance Whisper support and improve Settings UI ## Whisper Implementation Fixes - Fix Whisper transcription by removing unnecessary audio padding - Fix API usage: pass numpy array directly instead of torch tensor - Remove confusing model size remapping (users select exact model names) - Add fp16=False for CPU to prevent warnings - Fix missing 'import torch' in install-whisper.sh verification ## Audio System Improvements - Add ALSA error handler to suppress noisy warnings - Process remaining audio buffer when stopping recognition (fixes test button) ## Settings Dialog UI Enhancements - Add model metadata display (download status, size, recommendations) - Show ✓ for downloaded models, ↓ for pending downloads, ★ for recommended - Add system-based model recommendations (based on RAM/GPU) - Implement auto-apply settings on change (remove Apply button) - Fix VOSK settings visibility when Whisper is selected - Add VOSK model info panel with same features as Whisper - Fix test recognition to show results in dialog instead of injecting text - Fix race condition in test result display ## Startup Improvements - Load saved config on startup (engine/model now persists correctly) - Settings are remembered between app restarts ## Code Quality - Add get_text_callbacks/set_text_callbacks methods for test isolation - Update tests with proper mocking |
||
|
Jatin K MalikandGitHub
|
d265607d40 |
feat: Add comprehensive logging system with UI for debugging text injection issues (#31)
* feat: Add comprehensive logging system with UI for debugging 🔍 New Logging Features: - Add LoggingManager for centralized log capture and management - Add LoggingDialog with real-time log viewing, filtering, and export - Add 'View Logs' menu item to system tray for easy access - Support log filtering by level (DEBUG, INFO, WARNING, ERROR, CRITICAL) - Support log filtering by module name - Export logs to text files with applied filters - Auto-scroll functionality for real-time log monitoring - Log statistics and management (clear logs, view counts) 🐛 Enhanced Text Injection Debugging: - Add detailed logging for text injection process - Log target window information (name, class, PID, process) - Log injection chunks and retry attempts - Add timeout handling with detailed error messages - Log environment detection and tool selection - Enhanced error reporting with stack traces 🎯 UI Improvements: - Integrated logging dialog with GTK interface - Color-coded log levels for easy identification - Real-time log updates in the UI - Export functionality with file chooser dialog - Status bar showing log statistics - Non-modal dialog for continuous monitoring 📁 New Files: - src/vocalinux/ui/logging_manager.py - Core logging management - src/vocalinux/ui/logging_dialog.py - GTK logging viewer dialog This will help debug text injection issues in applications like TextEdit and terminal where voice typing may not work as expected. * fix: Improve logging dialog UI layout and add clipboard functionality 🎨 UI Layout Improvements: - Increase dialog default size from 900x600 to 900x700 - Set minimum content height for scrolled window to 400px - Enable vertical and horizontal expansion for text view and scrolled window - Ensure log text area takes up most of the available dialog space 📋 Clipboard Functionality: - Add 'Copy All' button to dialog for easy log sharing - Implement clipboard copy with formatted headers and timestamps - Add user feedback messages for successful/failed copy operations - Include line count information in success messages - Handle empty log cases gracefully 🔧 Technical Improvements: - Proper GTK clipboard integration using Gdk.SELECTION_CLIPBOARD - Error handling for clipboard operations - Formatted clipboard content with metadata headers - Thread-safe clipboard operations This fixes the issue where the log text area was too short and users could barely see 2 lines despite having plenty of vertical space available. The new layout ensures the text view expands to fill the available space, and the clipboard functionality makes it easy to share logs for debugging. |
||
|
Jatin K MalikandGitHub
|
f468be627d |
feat: comprehensive bug fixes and feature improvements (#30)
Major improvements and fixes: 🐛 Bug Fixes: - Fix VOSK model download URL (v0.42 -> v0.22 for large model) - Fix resource path resolution across different installation methods - Fix missing error handling for audio library imports - Fix text injection return value handling - Fix test compatibility issues with updated imports ✨ New Features: - Add centralized ResourceManager for consistent resource access - Add ActionHandler for voice commands (delete, undo, redo, select, etc.) - Add keyboard shortcut support for text injection - Add comprehensive dependency checking with helpful error messages - Add resource validation with detailed reporting 🔧 Improvements: - Eliminate code duplication in resource path finding - Enhance error handling with user-friendly messages - Improve Wayland/X11 compatibility - Add proper return type annotations - Enhance test coverage and fix failing tests 📁 New Files: - src/vocalinux/utils/resource_manager.py - Centralized resource management - src/vocalinux/ui/action_handler.py - Voice command action processing - src/vocalinux/utils/__init__.py - Utils package initialization 🧪 Testing: - All tests now pass (76 passed, 28 skipped) - Updated test mocks for new architecture - Fixed import issues in test files This makes VocaLinux production-ready with robust error handling, complete feature implementation, and improved maintainability. |
||
|
Jatin K MalikandGitHub
|
b5af600714 |
Custom Icons Implementation and Package Restructuring (#21)
* Implement custom icon for Vocalinux (Closes #10) * Fix system tray icon display issue * Temp commit before purging * refactor: restructure project into proper vocalinux package * test: fix and improve audio_feedback and tray_indicator tests with proper mocking and isolation * test: update import paths in test files to use the new package structure * Remove icon background * fix: implement robust resource path discovery in audio_feedback module * fix: improve resource discovery across application for consistent icon and sound loading * chore: ensure uninstall script is compatible with new resource paths * Fix black formatting |