termux-tts 1.4.2 → 1.4.3

package/termux_tts/engine_native.py

@@ -1,104 +1,104 @@
-"""
-Android OS System Native TTS Engine Bridge (Option B).
-Directly communicates with Samsung / Google Voice Engine via Termux IPC.
-Provides authentic human speech output with zero download overhead.
-"""
-
-import os
-import time
-import subprocess
-import shutil
-from dataclasses import dataclass
-from typing import Optional
-
-from .exceptions import TTSInferenceError
-
-@dataclass
-class NativeResult:
-    text: str
-    output_path: Optional[str]
-    language: str
-    pitch: float
-    rate: float
-    elapsed_ms: float
-    engine_name: str
-
-class NativeAndroidEngine:
-    """Android System Native TTS Engine Bridge (Samsung / Google Voice)."""
-
-    def __init__(
-        self,
-        language: str = "ko",
-        pitch: float = 1.0,
-        rate: float = 1.0,
-        stream: str = "MUSIC"
-    ):
-        self.language = language
-        self.pitch = pitch
-        self.rate = rate
-        self.stream = stream
-        self.binary = self._find_binary()
-
-    def _find_binary(self) -> Optional[str]:
-        bin_path = shutil.which("termux-tts-speak")
-        if bin_path and os.access(bin_path, os.X_OK):
-            return bin_path
-        default_p = "/data/data/com.termux/files/usr/bin/termux-tts-speak"
-        if os.path.exists(default_p) and os.access(default_p, os.X_OK):
-            return default_p
-        return None
-
-    def speak(self, text: str, stream: Optional[str] = None) -> NativeResult:
-        """Speak text directly through physical Android device speakers via termux-tts-speak IPC."""
-        if not text or not text.strip():
-            raise TTSInferenceError("Input text cannot be empty or whitespace only.")
-
-        if not self.binary:
-            raise TTSInferenceError(
-                "[FAIL-FAST] 'termux-tts-speak' binary not found on this system. "
-                "NativeAndroidEngine requires an Android Termux environment with 'termux-api' installed (run 'pkg install termux-api'). "
-                "If running on non-Android Linux/macOS/Windows, please use '--engine dsp' or '--engine onnx'."
-            )
-
-        t0 = time.perf_counter()
-        target_stream = stream or self.stream
-        cmd = [
-            self.binary,
-            "-l", self.language,
-            "-p", str(self.pitch),
-            "-r", str(self.rate),
-            "-s", target_stream,
-            text
-        ]
-
-        try:
-            res = subprocess.run(cmd, capture_output=True, text=True, timeout=30)
-            if res.returncode != 0:
-                err_msg = res.stderr.strip() or f"Process exited with code {res.returncode}"
-                raise TTSInferenceError(f"Native Android TTS engine execution failed: {err_msg}")
-        except subprocess.TimeoutExpired as e:
-            raise TTSInferenceError(f"Native Android TTS execution timed out (30s): {e}") from e
-        except Exception as e:
-            raise TTSInferenceError(f"Failed to execute native Android TTS: {e}") from e
-
-        elapsed_ms = (time.perf_counter() - t0) * 1000.0
-        return NativeResult(
-            text=text,
-            output_path=None,
-            language=self.language,
-            pitch=self.pitch,
-            rate=self.rate,
-            elapsed_ms=elapsed_ms,
-            engine_name="Android_Native_Voice_Engine"
-        )
-
-    def close(self) -> None:
-        pass
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        self.close()
-
-
+"""
+Android OS System Native TTS Engine Bridge (Option B).
+Directly communicates with Samsung / Google Voice Engine via Termux IPC.
+Provides authentic human speech output with zero download overhead.
+"""
+
+import os
+import time
+import subprocess
+import shutil
+from dataclasses import dataclass
+from typing import Optional
+
+from .exceptions import TTSInferenceError
+
+@dataclass
+class NativeResult:
+    text: str
+    output_path: Optional[str]
+    language: str
+    pitch: float
+    rate: float
+    elapsed_ms: float
+    engine_name: str
+
+class NativeAndroidEngine:
+    """Android System Native TTS Engine Bridge (Samsung / Google Voice)."""
+
+    def __init__(
+        self,
+        language: str = "ko",
+        pitch: float = 1.0,
+        rate: float = 1.0,
+        stream: str = "MUSIC"
+    ):
+        self.language = language
+        self.pitch = pitch
+        self.rate = rate
+        self.stream = stream
+        self.binary = self._find_binary()
+
+    def _find_binary(self) -> Optional[str]:
+        bin_path = shutil.which("termux-tts-speak")
+        if bin_path and os.access(bin_path, os.X_OK):
+            return bin_path
+        default_p = "/data/data/com.termux/files/usr/bin/termux-tts-speak"
+        if os.path.exists(default_p) and os.access(default_p, os.X_OK):
+            return default_p
+        return None
+
+    def speak(self, text: str, stream: Optional[str] = None) -> NativeResult:
+        """Speak text directly through physical Android device speakers via termux-tts-speak IPC."""
+        if not text or not text.strip():
+            raise TTSInferenceError("Input text cannot be empty or whitespace only.")
+
+        if not self.binary:
+            raise TTSInferenceError(
+                "[FAIL-FAST] 'termux-tts-speak' binary not found on this system. "
+                "NativeAndroidEngine requires an Android Termux environment with 'termux-api' installed (run 'pkg install termux-api'). "
+                "If running on non-Android Linux/macOS/Windows, please use '--engine dsp' or '--engine onnx'."
+            )
+
+        t0 = time.perf_counter()
+        target_stream = stream or self.stream
+        cmd = [
+            self.binary,
+            "-l", self.language,
+            "-p", str(self.pitch),
+            "-r", str(self.rate),
+            "-s", target_stream,
+            text
+        ]
+
+        try:
+            res = subprocess.run(cmd, capture_output=True, text=True, timeout=30)
+            if res.returncode != 0:
+                err_msg = res.stderr.strip() or f"Process exited with code {res.returncode}"
+                raise TTSInferenceError(f"Native Android TTS engine execution failed: {err_msg}")
+        except subprocess.TimeoutExpired as e:
+            raise TTSInferenceError(f"Native Android TTS execution timed out (30s): {e}") from e
+        except Exception as e:
+            raise TTSInferenceError(f"Failed to execute native Android TTS: {e}") from e
+
+        elapsed_ms = (time.perf_counter() - t0) * 1000.0
+        return NativeResult(
+            text=text,
+            output_path=None,
+            language=self.language,
+            pitch=self.pitch,
+            rate=self.rate,
+            elapsed_ms=elapsed_ms,
+            engine_name="Android_Native_Voice_Engine"
+        )
+
+    def close(self) -> None:
+        pass
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+
+

package/termux_tts/exceptions.py

@@ -1,28 +1,28 @@
-"""
-Domain Specific Exceptions for termux-tts (Strict Fail-Fast Protocol).
-Adheres to AOSF-ENG-STD-2026-V1 No-Fallback Governance.
-"""
-
-class TTSError(Exception):
-    """Base exception for all termux-tts domain errors."""
-    pass
-
-class TTSModelLoadError(TTSError):
-    """Raised when the neural TTS model file cannot be loaded or is corrupted."""
-    pass
-
-class TTSInferenceError(TTSError):
-    """Raised when tensor forward pass or audio synthesis fails."""
-    pass
-
-class VulkanInitializationError(TTSInferenceError):
-    """Raised when Vulkan GPU is explicitly requested but unavailable (Strict Fail-Fast)."""
-    pass
-
-class TTSAudioEncodingError(TTSError):
-    """Raised when raw PCM cannot be encoded to standard WAV."""
-    pass
-
-class TTSLanguageNotSupportedError(TTSError):
-    """Raised when the requested language is not supported by the current tokenizer."""
-    pass
+"""
+Domain Specific Exceptions for termux-tts (Strict Fail-Fast Protocol).
+Adheres to AOSF-ENG-STD-2026-V1 No-Fallback Governance.
+"""
+
+class TTSError(Exception):
+    """Base exception for all termux-tts domain errors."""
+    pass
+
+class TTSModelLoadError(TTSError):
+    """Raised when the neural TTS model file cannot be loaded or is corrupted."""
+    pass
+
+class TTSInferenceError(TTSError):
+    """Raised when tensor forward pass or audio synthesis fails."""
+    pass
+
+class VulkanInitializationError(TTSInferenceError):
+    """Raised when Vulkan GPU is explicitly requested but unavailable (Strict Fail-Fast)."""
+    pass
+
+class TTSAudioEncodingError(TTSError):
+    """Raised when raw PCM cannot be encoded to standard WAV."""
+    pass
+
+class TTSLanguageNotSupportedError(TTSError):
+    """Raised when the requested language is not supported by the current tokenizer."""
+    pass

package/termux_tts/installer.py

@@ -9,10 +9,37 @@ import urllib.request
 import shutil
 from pathlib import Path
 
-VULKAN_BINARY_RELEASE_URL = (
-    "https://github.com/uno-km/termux-sherpa-ncnn/releases/download/"
-    "v1.0.0-vulkan/sherpa-ncnn-offline-tts-vulkan-arm64.tar.gz"
-)
+def get_candidate_vulkan_binary_urls():
+    """Generate dynamic candidate endpoints for Vulkan binary provisioner."""
+    try:
+        from . import __version__
+    except Exception:
+        __version__ = "1.4.3"
+
+    urls = []
+    custom_tag = os.environ.get("TERMUX_TTS_RELEASE_TAG", "").strip()
+    custom_base = os.environ.get("TERMUX_TTS_RELEASE_BASE", "").strip()
+
+    if custom_base:
+        urls.append(f"{custom_base.rstrip('/')}/sherpa-ncnn-offline-tts-vulkan-arm64.tar.gz")
+    if custom_tag:
+        tag = custom_tag if custom_tag.startswith("v") else f"v{custom_tag}"
+        urls.append(f"https://github.com/uno-km/termux-tts/releases/download/{tag}/sherpa-ncnn-offline-tts-vulkan-arm64.tar.gz")
+
+    # 1. termux-tts current version SSOT
+    current_tag = f"v{__version__}"
+    urls.append(f"https://github.com/uno-km/termux-tts/releases/download/{current_tag}/sherpa-ncnn-offline-tts-vulkan-arm64.tar.gz")
+
+    # 2. termux-tts latest release
+    urls.append("https://github.com/uno-km/termux-tts/releases/latest/download/sherpa-ncnn-offline-tts-vulkan-arm64.tar.gz")
+
+    # 3. ameva-runtime unified SSOT ecosystem release fallback
+    urls.append("https://github.com/uno-km/ameva-runtime/releases/latest/download/sherpa-ncnn-offline-tts-vulkan-arm64.tar.gz")
+
+    # 4. Companion release fallback
+    urls.append("https://github.com/uno-km/termux-sherpa-ncnn/releases/download/v1.0.0-vulkan/sherpa-ncnn-offline-tts-vulkan-arm64.tar.gz")
+
+    return urls
 
 MODEL_REGISTRY = {
     "high": {
@@ -48,8 +75,13 @@ def get_install_paths():
     return bin_dir, cache_dir
 
 def download_with_progress(url: str, dest_path: Path, label: str):
+    try:
+        from . import __version__
+    except Exception:
+        __version__ = "1.4.3"
+
     print(f"  [DOWNLOADING] {label}...")
-    req = urllib.request.Request(url, headers={"User-Agent": "termux-tts-installer/1.3.0"})
+    req = urllib.request.Request(url, headers={"User-Agent": f"termux-tts-installer/{__version__} (Android; ARM64)"})
     with urllib.request.urlopen(req) as resp, open(dest_path, "wb") as out_f:
         total = int(resp.headers.get("Content-Length", 0))
         downloaded = 0
@@ -69,13 +101,30 @@ def download_with_progress(url: str, dest_path: Path, label: str):
 def install_vulkan_binary(force: bool = False) -> Path:
     bin_dir, _ = get_install_paths()
     binary_path = bin_dir / "sherpa-ncnn-offline-tts"
+    prefix_bin = Path(os.environ.get("PREFIX", "/data/data/com.termux/files/usr")) / "bin"
     
     if binary_path.exists() and not force:
         print(f"  [OK] Pre-compiled Vulkan binary already exists: {binary_path}")
         return binary_path
 
     tar_path = bin_dir / "sherpa-vulkan.tar.gz"
-    download_with_progress(VULKAN_BINARY_RELEASE_URL, tar_path, "ARM64 Vulkan Binary (3.9MB)")
+    candidate_urls = get_candidate_vulkan_binary_urls()
+    download_success = False
+
+    for url in candidate_urls:
+        try:
+            download_with_progress(url, tar_path, f"ARM64 Vulkan Binary ({url})")
+            if tar_path.exists() and tar_path.stat().st_size > 500 * 1024:
+                download_success = True
+                break
+        except Exception as dl_err:
+            print(f"  [-] Candidate URL failed ({url}): {dl_err}")
+            if tar_path.exists():
+                tar_path.unlink(missing_ok=True)
+            continue
+
+    if not download_success:
+        raise RuntimeError("Failed to download sherpa-ncnn-offline-tts from any candidate endpoints.")
 
     print("  [EXTRACTING] Installing binary to ~/.local/bin...")
     with tarfile.open(tar_path, "r:gz") as tar:
@@ -83,6 +132,17 @@ def install_vulkan_binary(force: bool = False) -> Path:
 
     tar_path.unlink(missing_ok=True)
     binary_path.chmod(0o755)
+
+    # Dual-path installation to PREFIX/bin if writable
+    try:
+        if prefix_bin.exists() and os.access(prefix_bin, os.W_OK):
+            target_prefix_bin = prefix_bin / "sherpa-ncnn-offline-tts"
+            shutil.copy2(binary_path, target_prefix_bin)
+            target_prefix_bin.chmod(0o755)
+            print(f"  [SYMLINK/COPY] Linked to {target_prefix_bin}")
+    except OSError:
+        pass
+
     print(f"  [SUCCESS] Installed: {binary_path}")
     return binary_path