Skip to content

STT-CLI v1.3 - Balloon Notifications & Bug Fixes

Choose a tag to compare

View all tags
@Mantej-Singh Mantej-Singh released this 29 Oct 17:32
· 8 commits to main since this release
v1.3
36233c0
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Release Date: October 29, 2025
Build Size: 77MB

🆕 What's New

Balloon Notifications 🔔

STT-CLI now shows Windows balloon notifications when you start or stop recording! You'll get clear visual
confirmation that your hotkey press was detected - no more watching the system tray icon.

  • Recording Started: Shows notification with reminder "Double-tap Left Alt to stop recording"
  • Recording Stopped: Confirms your recording has ended
  • Notifications auto-dismiss after 2-3 seconds
  • Professional Windows 10/11 integration

🐛 Critical Bug Fixes

Multi-Toggle Issue ✅

Fixed the most critical bug: Recording would flash on/off when stopping.

Problem: Rapid Alt key presses (4-6 times) would trigger multiple toggles, making the app appear broken.

Solution: Added 800ms cooldown period after each toggle. Now only the first double-tap is processed, ignoring
accidental extra presses.

Impact: Recording now reliably stops when you want it to!

Exception Handling ✅

Added comprehensive try-catch blocks to keyboard event handlers to prevent the listener from crashing on
unexpected errors.

Build Process ✅

Fixed PyInstaller build to properly include all dependencies. Previous builds were missing pynput library.

🔧 Technical Improvements

Code Quality

  • ✅ 100% Type Coverage: Added type hints to all functions
  • ✅ Thread Safety: Implemented proper threading.Event() and locks
  • ✅ Resource Optimization: Icons cached at startup (no repeated file I/O)
  • ✅ Better Error Handling: All exceptions logged with full tracebacks
  • ✅ Clean Architecture: Improved state management with event synchronization

Documentation

  • ✅ Fixed logging to use %TEMP%\stt-cli\app.log (no more permission errors)
  • ✅ Updated build instructions with dependency installation steps
  • ✅ Comprehensive inline documentation with docstrings

📦 Installation

Option 1: Download Executable (Recommended)

Download speech-to-text-cli.exe from this release and run it. No installation or Python required!

Option 2: Build from Source

Clone the repository

git clone https://github.com/Mantej-Singh/stt-cli.git
cd stt-cli

Install dependencies

pip install -r requirements.txt

Run from source

python main.pyw

OR build your own executable

python -m PyInstaller --onefile --name "speech-to-text-cli" --icon "stt-cli2.ico" --noconsole --add-data
"stt-cli2.ico;." --add-data "stt-cli2.png;." --clean main.pyw

🚀 Usage

  1. Run the application (system tray icon appears)
  2. Open Windows Terminal, PowerShell, or CMD
  3. Double-tap Left Alt to start recording (balloon notification appears!)
  4. Speak - your words appear in the CLI window
  5. Double-tap Left Alt again to stop (notification confirms!)
  6. Right-click tray icon → Quit to exit

📊 Full Changelog

New Features

  • 🔔 Windows balloon notifications for recording start/stop
  • ⚙️ Configurable notification system (can be disabled in code)

Bug Fixes

  • 🐛 Fixed multi-toggle issue with 800ms cooldown period
  • 🐛 Added exception handling to keyboard callbacks
  • 🐛 Fixed PyInstaller missing pynput dependency
  • 🐛 Fixed logging permission issues (now uses TEMP directory)
  • 🐛 Fixed image resource leaks (icons cached at startup)
  • 🐛 Fixed race conditions with proper thread synchronization
  • 🐛 Documented ESC key side effect (clears terminal)

Technical Improvements

  • 📝 100% type hint coverage
  • 🔒 Thread-safe state management with threading.Event()
  • 🧵 Proper locks for compound operations
  • 🎯 Graceful shutdown with thread cleanup
  • 📚 Comprehensive documentation and docstrings
  • 🗂️ Better code organization and maintainability

Build Improvements

  • ✅ Fixed dependency bundling in PyInstaller
  • ✅ Updated build instructions in README
  • ✅ Verified exe works on clean Windows installations

💡 Known Limitations

  • ESC key quit feature: Pressing ESC to quit may clear your terminal screen (documented behavior)
  • Hotkey: Currently hardcoded to Left Alt double-tap (configurable in future versions)
  • Platform: Windows only (by design)

🔮 What's Next?

  • Configurable hotkeys
  • Additional visual indicators
  • Customizable notification messages

🙏 Feedback & Issues

Found a bug? Have a feature request? Please open an issue on GitHub!

📄 Requirements

  • OS: Windows 10 or Windows 11
  • No Admin Rights Required - Works perfectly on corporate laptops!
  • No Installation - Just download and run

Download speech-to-text-cli.exe below and start using voice commands in your CLI today! 🎤

Full Changelog: v1.0.0...v1.3

Assets 2
Loading