stttype 2.0.2__tar.gz → 2.0.4__tar.gz

{stttype-2.0.2 → stttype-2.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stttype
-Version: 2.0.2
+Version: 2.0.4
 Summary: Cross-platform voice-to-text typing assistant with GPU acceleration and automatic CPU fallback
 Author: LucasApps
 License: MIT
@@ -37,44 +37,54 @@ Provides-Extra: gpu
 Requires-Dist: torch>=2.0.0; extra == "gpu"
 Requires-Dist: torchaudio>=2.0.0; extra == "gpu"
 
-# STT Type v1.0.0
+# STT Type v2.0.3
 
-**Python based STT module running on GPU.**
+**Cross-platform voice-to-text typing assistant with GPU acceleration and automatic CPU fallback.**
 
-Hold **F2** to record your voice, release to transcribe and type the text automatically at your cursor position.
+Hold **F2** (configurable) to record your voice, release to transcribe and type the text automatically at your cursor position.
 
 ## Features
 
 - **Cross-platform** - Works on Windows, Linux, and macOS
-- **Hold F2 to record** - Audio captures while key is held
-- **Visual indicator** - Semi-transparent red dot with "F2" label appears in top-right corner while recording
+- **Hold hotkey to record** - Audio captures while key is held (default: F2)
+- **Visual indicator** - Transparent red dot with hotkey label appears in top-right corner while recording
 - **Bell sounds** - Audio feedback when recording starts/stops
 - **GPU-accelerated STT** - Uses faster-whisper on your NVIDIA GPU
-- **Auto-typing** - Transcribed text is typed at cursor position
+- **Auto CPU fallback** - Automatically falls back to CPU if GPU is not available
+- **Clipboard typing** - Types text via Ctrl+V paste for reliability (no key interference)
 - **System tray mode** - Runs silently in background
-- **Auto-startup** - Starts automatically on login
+- **Auto-startup** - Starts automatically on login (Windows)
+- **Settings GUI** - `stttype --config` to change model, language, device, compute type, and hotkey
 
 ## Requirements
 
 - Python 3.9+
-- NVIDIA GPU with CUDA support (for GPU mode)
 - Microphone
+- NVIDIA GPU with CUDA support (optional, for GPU mode)
 
 ## Installation
 
-### Prerequisites
+### From PyPI (Recommended)
 
-Install PyTorch with CUDA support:
+```bash
+pip install stttype
+```
+
+### Prerequisites (Optional GPU Support)
+
+Install PyTorch with CUDA support for GPU acceleration:
 
 ```bash
-# Windows/Linux
+# Windows/Linux with CUDA 11.8
 pip install torch torchaudio --index-url https://download.pytorch.org/whl/cu118
 
 # macOS (CPU only, no CUDA)
 pip install torch torchaudio
 ```
 
-### Windows
+Without PyTorch, STT Type will still work — it automatically falls back to CPU.
+
+### Windows (Local Install)
 
 ```powershell
 cd "E:\Lucas\STT Type"
@@ -128,8 +138,9 @@ Once installed, `stttype` works from any terminal.
 | `stttype --shutdown` | Stop all STT Type processes |
 | `stttype --status` | Check if STT Type is running |
 | `stttype --restart` | Restart STT Type |
-| `stttype --addtostartup` | Add to startup |
-| `stttype --rmtostartup` | Remove from startup |
+| `stttype --config` | Open settings GUI |
+| `stttype --addtostartup` | Add to startup (Windows only) |
+| `stttype --rmtostartup` | Remove from startup (Windows only) |
 | `stttype --model <size>` | Set Whisper model (tiny/base/small/medium/large-v3) |
 | `stttype --lang <code>` | Set language (en/zh/auto/etc) |
 | `stttype --help` | Show help |
@@ -148,14 +159,31 @@ stttype --start --lang zh
 
 # Start with small model and auto-detect language
 stttype --start --model small --lang auto
+
+# Open settings GUI
+stttype --config
 ```
 
+### Settings GUI
+
+Run `stttype --config` to open a settings window where you can configure:
+
+| Setting | Options |
+|---------|---------|
+| **Whisper Model** | tiny, base, small, medium, large-v3 |
+| **Language** | Auto-detect, English, Chinese, Spanish, French, German, Japanese, Korean, Russian, Italian, Portuguese, Arabic, Hindi |
+| **Device** | Auto (GPU if available), GPU (CUDA), CPU |
+| **Compute Type** | Auto, Float16 (GPU), Int8 (CPU) |
+| **Hotkey** | F1 - F12 |
+
+Settings are saved to `~/.config/stttype/config.json` and persist across restarts.
+
 ## How It Works
 
-1. **Hold F2** - A semi-transparent red dot with "F2" appears in the top-right corner, microphone starts recording
-2. **Release F2** - Red dot disappears, recording stops
-3. **GPU transcribes** - Whisper processes audio on your NVIDIA GPU
-4. **Text is typed** - Result appears at your cursor position
+1. **Hold hotkey** (default F2) - A transparent red dot appears in the top-right corner, microphone starts recording
+2. **Release hotkey** - Red dot disappears, recording stops
+3. **GPU/CPU transcribes** - Whisper processes audio (GPU if available, else CPU)
+4. **Text is pasted** - Result is pasted at your cursor position via Ctrl+V
 
 ## Models
 
@@ -189,12 +217,13 @@ chmod +x uninstall.sh
 | Issue | Solution |
 |-------|----------|
 | `stttype` not found | Restart terminal after installation |
-| "CUDA not available" | Install NVIDIA drivers and CUDA toolkit |
+| "CUDA not available" | Install NVIDIA drivers and CUDA toolkit, or STT Type will auto-fallback to CPU |
 | No sound on start/stop | Check system volume |
 | Text not typing | Make sure the target window is focused |
 | Model download fails | Check internet connection |
 | Hotkeys don't work (macOS) | Grant Accessibility permissions to your terminal |
 | Hotkeys don't work (Linux) | Make sure you're running under X11 (not Wayland) |
+| Garbled text when typing | Fixed in v2.0.2+ — uses clipboard paste instead of key simulation |
 
 ## Publish to PyPI
 
@@ -217,5 +246,5 @@ When prompted:
 ---
 
 **Author**: LucasApps  
-**Version**: 1.0.0  
+**Version**: 2.0.3  
 **License**: MIT

{stttype-2.0.2 → stttype-2.0.4}/README.md

@@ -1,41 +1,51 @@
-# STT Type v1.0.0
+# STT Type v2.0.3
 
-**Python based STT module running on GPU.**
+**Cross-platform voice-to-text typing assistant with GPU acceleration and automatic CPU fallback.**
 
-Hold **F2** to record your voice, release to transcribe and type the text automatically at your cursor position.
+Hold **F2** (configurable) to record your voice, release to transcribe and type the text automatically at your cursor position.
 
 ## Features
 
 - **Cross-platform** - Works on Windows, Linux, and macOS
-- **Hold F2 to record** - Audio captures while key is held
-- **Visual indicator** - Semi-transparent red dot with "F2" label appears in top-right corner while recording
+- **Hold hotkey to record** - Audio captures while key is held (default: F2)
+- **Visual indicator** - Transparent red dot with hotkey label appears in top-right corner while recording
 - **Bell sounds** - Audio feedback when recording starts/stops
 - **GPU-accelerated STT** - Uses faster-whisper on your NVIDIA GPU
-- **Auto-typing** - Transcribed text is typed at cursor position
+- **Auto CPU fallback** - Automatically falls back to CPU if GPU is not available
+- **Clipboard typing** - Types text via Ctrl+V paste for reliability (no key interference)
 - **System tray mode** - Runs silently in background
-- **Auto-startup** - Starts automatically on login
+- **Auto-startup** - Starts automatically on login (Windows)
+- **Settings GUI** - `stttype --config` to change model, language, device, compute type, and hotkey
 
 ## Requirements
 
 - Python 3.9+
-- NVIDIA GPU with CUDA support (for GPU mode)
 - Microphone
+- NVIDIA GPU with CUDA support (optional, for GPU mode)
 
 ## Installation
 
-### Prerequisites
+### From PyPI (Recommended)
 
-Install PyTorch with CUDA support:
+```bash
+pip install stttype
+```
+
+### Prerequisites (Optional GPU Support)
+
+Install PyTorch with CUDA support for GPU acceleration:
 
 ```bash
-# Windows/Linux
+# Windows/Linux with CUDA 11.8
 pip install torch torchaudio --index-url https://download.pytorch.org/whl/cu118
 
 # macOS (CPU only, no CUDA)
 pip install torch torchaudio
 ```
 
-### Windows
+Without PyTorch, STT Type will still work — it automatically falls back to CPU.
+
+### Windows (Local Install)
 
 ```powershell
 cd "E:\Lucas\STT Type"
@@ -89,8 +99,9 @@ Once installed, `stttype` works from any terminal.
 | `stttype --shutdown` | Stop all STT Type processes |
 | `stttype --status` | Check if STT Type is running |
 | `stttype --restart` | Restart STT Type |
-| `stttype --addtostartup` | Add to startup |
-| `stttype --rmtostartup` | Remove from startup |
+| `stttype --config` | Open settings GUI |
+| `stttype --addtostartup` | Add to startup (Windows only) |
+| `stttype --rmtostartup` | Remove from startup (Windows only) |
 | `stttype --model <size>` | Set Whisper model (tiny/base/small/medium/large-v3) |
 | `stttype --lang <code>` | Set language (en/zh/auto/etc) |
 | `stttype --help` | Show help |
@@ -109,14 +120,31 @@ stttype --start --lang zh
 
 # Start with small model and auto-detect language
 stttype --start --model small --lang auto
+
+# Open settings GUI
+stttype --config
 ```
 
+### Settings GUI
+
+Run `stttype --config` to open a settings window where you can configure:
+
+| Setting | Options |
+|---------|---------|
+| **Whisper Model** | tiny, base, small, medium, large-v3 |
+| **Language** | Auto-detect, English, Chinese, Spanish, French, German, Japanese, Korean, Russian, Italian, Portuguese, Arabic, Hindi |
+| **Device** | Auto (GPU if available), GPU (CUDA), CPU |
+| **Compute Type** | Auto, Float16 (GPU), Int8 (CPU) |
+| **Hotkey** | F1 - F12 |
+
+Settings are saved to `~/.config/stttype/config.json` and persist across restarts.
+
 ## How It Works
 
-1. **Hold F2** - A semi-transparent red dot with "F2" appears in the top-right corner, microphone starts recording
-2. **Release F2** - Red dot disappears, recording stops
-3. **GPU transcribes** - Whisper processes audio on your NVIDIA GPU
-4. **Text is typed** - Result appears at your cursor position
+1. **Hold hotkey** (default F2) - A transparent red dot appears in the top-right corner, microphone starts recording
+2. **Release hotkey** - Red dot disappears, recording stops
+3. **GPU/CPU transcribes** - Whisper processes audio (GPU if available, else CPU)
+4. **Text is pasted** - Result is pasted at your cursor position via Ctrl+V
 
 ## Models
 
@@ -150,12 +178,13 @@ chmod +x uninstall.sh
 | Issue | Solution |
 |-------|----------|
 | `stttype` not found | Restart terminal after installation |
-| "CUDA not available" | Install NVIDIA drivers and CUDA toolkit |
+| "CUDA not available" | Install NVIDIA drivers and CUDA toolkit, or STT Type will auto-fallback to CPU |
 | No sound on start/stop | Check system volume |
 | Text not typing | Make sure the target window is focused |
 | Model download fails | Check internet connection |
 | Hotkeys don't work (macOS) | Grant Accessibility permissions to your terminal |
 | Hotkeys don't work (Linux) | Make sure you're running under X11 (not Wayland) |
+| Garbled text when typing | Fixed in v2.0.2+ — uses clipboard paste instead of key simulation |
 
 ## Publish to PyPI
 
@@ -178,5 +207,5 @@ When prompted:
 ---
 
 **Author**: LucasApps  
-**Version**: 1.0.0  
+**Version**: 2.0.3  
 **License**: MIT

{stttype-2.0.2 → stttype-2.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stttype"
-version = "2.0.2"
+version = "2.0.4"
 description = "Cross-platform voice-to-text typing assistant with GPU acceleration and automatic CPU fallback"
 readme = "README.md"
 requires-python = ">=3.9"

{stttype-2.0.2 → stttype-2.0.4}/stttype/config_ui.py

@@ -186,11 +186,22 @@ def run_config_ui():
     btn_frame.pack(pady=20)
 
     def on_save():
+        # Ensure we extract raw values (not display labels)
+        dev_val = device_var.get()
+        if " - " in dev_val:
+            dev_val = dev_val.split(" - ")[0]
+        comp_val = compute_var.get()
+        if " - " in comp_val:
+            comp_val = comp_val.split(" - ")[0]
+        lang_val = lang_var.get()
+        if " - " in lang_val:
+            lang_val = lang_val.split(" - ")[0]
+        
         new_config = {
             "model": model_var.get(),
-            "language": lang_var.get(),
-            "device": device_var.get(),
-            "compute_type": compute_var.get(),
+            "language": lang_val,
+            "device": dev_val,
+            "compute_type": comp_val,
             "hotkey": hotkey_var.get().lower(),
         }
         save_config(new_config)

{stttype-2.0.2 → stttype-2.0.4}/stttype.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stttype
-Version: 2.0.2
+Version: 2.0.4
 Summary: Cross-platform voice-to-text typing assistant with GPU acceleration and automatic CPU fallback
 Author: LucasApps
 License: MIT
@@ -37,44 +37,54 @@ Provides-Extra: gpu
 Requires-Dist: torch>=2.0.0; extra == "gpu"
 Requires-Dist: torchaudio>=2.0.0; extra == "gpu"
 
-# STT Type v1.0.0
+# STT Type v2.0.3
 
-**Python based STT module running on GPU.**
+**Cross-platform voice-to-text typing assistant with GPU acceleration and automatic CPU fallback.**
 
-Hold **F2** to record your voice, release to transcribe and type the text automatically at your cursor position.
+Hold **F2** (configurable) to record your voice, release to transcribe and type the text automatically at your cursor position.
 
 ## Features
 
 - **Cross-platform** - Works on Windows, Linux, and macOS
-- **Hold F2 to record** - Audio captures while key is held
-- **Visual indicator** - Semi-transparent red dot with "F2" label appears in top-right corner while recording
+- **Hold hotkey to record** - Audio captures while key is held (default: F2)
+- **Visual indicator** - Transparent red dot with hotkey label appears in top-right corner while recording
 - **Bell sounds** - Audio feedback when recording starts/stops
 - **GPU-accelerated STT** - Uses faster-whisper on your NVIDIA GPU
-- **Auto-typing** - Transcribed text is typed at cursor position
+- **Auto CPU fallback** - Automatically falls back to CPU if GPU is not available
+- **Clipboard typing** - Types text via Ctrl+V paste for reliability (no key interference)
 - **System tray mode** - Runs silently in background
-- **Auto-startup** - Starts automatically on login
+- **Auto-startup** - Starts automatically on login (Windows)
+- **Settings GUI** - `stttype --config` to change model, language, device, compute type, and hotkey
 
 ## Requirements
 
 - Python 3.9+
-- NVIDIA GPU with CUDA support (for GPU mode)
 - Microphone
+- NVIDIA GPU with CUDA support (optional, for GPU mode)
 
 ## Installation
 
-### Prerequisites
+### From PyPI (Recommended)
 
-Install PyTorch with CUDA support:
+```bash
+pip install stttype
+```
+
+### Prerequisites (Optional GPU Support)
+
+Install PyTorch with CUDA support for GPU acceleration:
 
 ```bash
-# Windows/Linux
+# Windows/Linux with CUDA 11.8
 pip install torch torchaudio --index-url https://download.pytorch.org/whl/cu118
 
 # macOS (CPU only, no CUDA)
 pip install torch torchaudio
 ```
 
-### Windows
+Without PyTorch, STT Type will still work — it automatically falls back to CPU.
+
+### Windows (Local Install)
 
 ```powershell
 cd "E:\Lucas\STT Type"
@@ -128,8 +138,9 @@ Once installed, `stttype` works from any terminal.
 | `stttype --shutdown` | Stop all STT Type processes |
 | `stttype --status` | Check if STT Type is running |
 | `stttype --restart` | Restart STT Type |
-| `stttype --addtostartup` | Add to startup |
-| `stttype --rmtostartup` | Remove from startup |
+| `stttype --config` | Open settings GUI |
+| `stttype --addtostartup` | Add to startup (Windows only) |
+| `stttype --rmtostartup` | Remove from startup (Windows only) |
 | `stttype --model <size>` | Set Whisper model (tiny/base/small/medium/large-v3) |
 | `stttype --lang <code>` | Set language (en/zh/auto/etc) |
 | `stttype --help` | Show help |
@@ -148,14 +159,31 @@ stttype --start --lang zh
 
 # Start with small model and auto-detect language
 stttype --start --model small --lang auto
+
+# Open settings GUI
+stttype --config
 ```
 
+### Settings GUI
+
+Run `stttype --config` to open a settings window where you can configure:
+
+| Setting | Options |
+|---------|---------|
+| **Whisper Model** | tiny, base, small, medium, large-v3 |
+| **Language** | Auto-detect, English, Chinese, Spanish, French, German, Japanese, Korean, Russian, Italian, Portuguese, Arabic, Hindi |
+| **Device** | Auto (GPU if available), GPU (CUDA), CPU |
+| **Compute Type** | Auto, Float16 (GPU), Int8 (CPU) |
+| **Hotkey** | F1 - F12 |
+
+Settings are saved to `~/.config/stttype/config.json` and persist across restarts.
+
 ## How It Works
 
-1. **Hold F2** - A semi-transparent red dot with "F2" appears in the top-right corner, microphone starts recording
-2. **Release F2** - Red dot disappears, recording stops
-3. **GPU transcribes** - Whisper processes audio on your NVIDIA GPU
-4. **Text is typed** - Result appears at your cursor position
+1. **Hold hotkey** (default F2) - A transparent red dot appears in the top-right corner, microphone starts recording
+2. **Release hotkey** - Red dot disappears, recording stops
+3. **GPU/CPU transcribes** - Whisper processes audio (GPU if available, else CPU)
+4. **Text is pasted** - Result is pasted at your cursor position via Ctrl+V
 
 ## Models
 
@@ -189,12 +217,13 @@ chmod +x uninstall.sh
 | Issue | Solution |
 |-------|----------|
 | `stttype` not found | Restart terminal after installation |
-| "CUDA not available" | Install NVIDIA drivers and CUDA toolkit |
+| "CUDA not available" | Install NVIDIA drivers and CUDA toolkit, or STT Type will auto-fallback to CPU |
 | No sound on start/stop | Check system volume |
 | Text not typing | Make sure the target window is focused |
 | Model download fails | Check internet connection |
 | Hotkeys don't work (macOS) | Grant Accessibility permissions to your terminal |
 | Hotkeys don't work (Linux) | Make sure you're running under X11 (not Wayland) |
+| Garbled text when typing | Fixed in v2.0.2+ — uses clipboard paste instead of key simulation |
 
 ## Publish to PyPI
 
@@ -217,5 +246,5 @@ When prompted:
 ---
 
 **Author**: LucasApps  
-**Version**: 1.0.0  
+**Version**: 2.0.3  
 **License**: MIT