What's New in RightSub v1.3.0
Key Highlights
- Semantic AI Polish & Subtitle Quality Control (
rightsub polish): Autonomous proofreading engine for existing subtitles. Combines zero-token deterministic franchise canon rules with bilingual cue alignment, Markdown diff reporting, and seed-safe protection. - Hierarchical Domain Knowledge Engine & 3-Tier Classification: Intelligent context detector operating across 3 tiers (Tier 1: TMDb genres & translation bibles; Tier 2: Franchise/title patterns; Tier 3: Offline lexical cue fingerprinting). Features domain packs (
SCI_FI,MILITARY,LEGAL,MEDICAL,FANTASY,UNIVERSAL_IDIOMS) and Bilingual Anchor Validation to completely eliminate cross-genre false positives. - Split-Cue Partitioning & Forward Anticipation Drift Guard: Advanced cue alignment with
split_partmarkers and a real-time drift guard preventing the LLM from collapsing split cues or leaking future dialogue lines ahead of time, ensuring 100% dialogue synchronization. - Network Storage (SMB/NAS) Timestamp Synchronization: Explicit filesystem metadata flushing (
os.utime) on all mastered subtitles, diff audit reports, and backups, preventing macOS SMB clients from falling back to Apple's CoreFoundation epoch (2001-01-01). - Translation Bible & TMDb Plot Context Ingestion: Integrates companion
translation_bible.json(or via explicit-b/--bibleflag) along with TMDb plot overview, genres, and full verified character cast rosters with grammatical gender tags before running the LLM pass. - Adaptive Model Cascade & Google API Hardening: Multi-tier waterfall fallback (
gemini-3.8-flashβgemini-3.7-flashβgemini-3.6-flashβgemini-3.5-flashβgemini-3.5-flash-lite) with dynamic model discovery, real-time Google API error body parsing, handling for 429 quota and 503 overload errors, and working model lock-in for subsequent batches. - Official Homebrew Tap & Universal Bottle (
omerninyo/tap): Global 1-second installation on macOS (both Apple Silicon and Intel) via pre-packaged:allbottles on GitHub Releases, bypassing Xcode compiler checks completely. - Interactive Credentials Onboarding (
rightsub config): 10-second setup wizard for Google Gemini & TMDb API keys with live ping authentication checks and automated storage in~/.config/rightsub/config.json. - System Health Diagnostics (
rightsub doctor): End-to-end environment inspector verifying Python 3.9+, FFmpeg suite, TMDb, Gemini, Ollama daemon, and Quicksubs STT. - On-Device STT Engine Clarification & OS Safety: Apple SpeechAnalyzer integration for instant source audio transcription on Apple Silicon with macOS 26+ (Tahoe), with automated detection and clear guidance for Whisper (
whisper-cpp) on older macOS versions and for Hebrew audio transcription. - CLI
--version/-vFlag: Fast version inspection across terminal environments.
Full documentation: https://github.com/omerninyo/RightSub