vsub-cli: v1.3.0

1.3.0 (2026-09-05)

Features

• add i18n support with english default and japanese option (1f72470)
• add model not found fail-fast error handling and display active models in cli (dec7453)

Bundled Standalone Binary Environment

• Node.js Runtime: v26.8.1 (Single Executable Application)

vsub-cli: v1.2.0

1.2.0 (2026-09-03)

Features

• update default Gemini model to gemini-3.8-flash (74033cc)

Bundled Standalone Binary Environment

• Node.js Runtime: v26.8.1 (Single Executable Application)

vsub-cli: v1.1.2

1.1.2 (2026-08-22)

Bug Fixes

• build: apply macOS ad-hoc code signature to final destination binary after copy and add CI binary verification matrix (0a73315)
• ci: restore setup-env step in Typecheck & Build job (50c0cf3)
• ci: scope macOS binary builds to Apple Silicon arm64 (5258656)

Bundled Standalone Binary Environment

• Node.js Runtime: v26.7.0 (Single Executable Application)

vsub-cli: v1.1.1

1.1.1 (2026-08-22)

Bug Fixes

• ci: use verified commit SHAs for upload and download artifact actions (5f689a1)

Bundled Standalone Binary Environment

• Node.js Runtime: v26.7.0 (Single Executable Application)

vsub-cli: v1.1.0

1.1.0 (2026-08-22)

Features

• add custom Gemini and Groq model options (fe48f1f)
• add directory and batch bulk processing mode (vsub batch) (174d6f3)
• add file overwrite prevention and backup safety mechanisms (8ba5d7f)
• add Gemini API concurrency control for fast subtitle translation (25d33b8)
• add GitHub Actions CI matrix and Dependabot auto-merge pipeline (ce7e7d2)
• add glossary and custom prompt specification support (8c3867c)
• add interactive CLI configuration, translation control options, and Gemini/Groq integration modules (68b0a80)
• add interactive setup and verification wizard (vsub init) (3c943c0)
• add local automated E2E smoke test and update Gemini default model (25b88c4)
• add multi-format output support (.vtt, .txt, .json) (d578a7f)
• add real-time progress spinners and execution summary box (8272260)
• add standalone binary distribution (Node.js SEA) and third-party license management (32dc686)
• add test coverage measurement and reporting with vitest --coverage (f3ca049)
• add video subtitle burn-in support via FFmpeg subtitles filter (48317a8)
• add vsub translate subcommand for direct subtitle translation (4c2a1a5)
• ci: add automated AI model watcher with deduplicated issue alerts (ac67302)
• ci: enable workflow_dispatch trigger for manual execution (d90e651)
• implement automated quality gate hook for pre-termination verification (1204f18)
• implement CLI entry point and subtitle generation workflow using Commander, Groq, and Gemini (1c7b09e)
• implement global configuration management and interactive API key setup (50e0572)
• implement intermediate caching and resume mechanism for Groq and Gemini (82f4778)
• implement video-to-srt CLI with Groq transcription and Gemini translation support (c7772a8)
• initialize project with README, PRD, and ignore configuration (8a35349)
• initialize vsub-cli project with Groq transcription and Gemini translation capabilities (98c9eed)
• release: setup Release Please and npm publish pipeline (5f62261)
• setup token-saving final quality gate with stop hook and testing rules (034eba6)
• subtitles: add bilingual dual-language subtitles mode (--bilingual, -b) (99a971b)
• support direct audio file inputs (.mp3, .wav, etc.) (571e303)
• support multi-language simultaneous subtitle translation (-t ja,en,zh) (53ee2f5)
• transcription: improve timecode accuracy for split audio using measured playback duration (586cdfd)

Bug Fixes

• ci: install ffmpeg in setup-env composite action for test jobs (1bf84f6)
• ci: pin googleapis/release-please-action to full-length commit SHA (afbae2f)
• ci: specify packageManager in package.json for pnpm action setup (6b56482)
• ci: sync known AI models strictly with current live API endpoints (4b24edd)
• ci: update macOS Intel runner to macos-15-intel and upgrade artifact actions to v7.0.0 (dd69160)
• ci: use googleapis/release-please-action@v4 and align package metadata (ded5386)
• init: resolve biome noNonNullAssertion warning in init wizard (9439715)
• make resolveFfprobePath platform-agnostic across POSIX and Windows paths (490ac93)

v1.0.0

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

1.0.0 (Initial Release)

🎉 First official release of vsub-cli!

A fast and powerful CLI tool to extract audio, transcribe speech with Groq Whisper, and translate subtitles using Google Gemini API.

Key Features

• Audio Extraction & Optimization: Extract and normalize audio streams from video (.mp4, .mkv, .webm, .mov, etc.) and audio files (.mp3, .wav, .m4a, .flac, etc.) using FFmpeg.
• Fast Speech-to-Text: High-speed transcription powered by Groq Whisper API, supporting automatic audio splitting with millisecond-accurate timestamp sync for long media.
• AI-Powered Subtitle Translation: High-accuracy contextual subtitle translation using Google Gemini API (gemini-3.7-flash default) with multi-worker concurrent chunk processing.
• Multi-Language Batch Translation: Translate subtitles into multiple target languages simultaneously with a single command (e.g. -t ja,en,zh).
• Multi-Format Output: Output subtitles in .srt, .vtt (WebVTT), .txt (plain transcript), and .json (structured entries).
• Glossary & Custom Prompts: Enforce consistent terminology and style through inline glossaries, JSON glossary files, Whisper hints, and custom Gemini translation prompts.
• Direct SRT Translation: Dedicated vsub translate subcommand to translate existing SRT files directly without re-processing media.
• Video Hardsub / Burn-in: Dedicated vsub burn subcommand and --burn flag to render subtitles directly into MP4 videos via FFmpeg.
• Intelligent Caching: Automatic caching and resume capability (vsub cache) to eliminate redundant Whisper and Gemini API calls.
• Safety & Overwrite Protection: Pre-execution collision check, interactive confirmation, and automatic .bak backups (--backup, -w).
• Persistent Configuration: Global CLI settings (vsub config set/show/get/delete) for API keys, models, and default concurrency.
• Rich CLI UX: Real-time spinner indicators, detailed error handling, and end-of-run execution summary tables.