One-Click Subtitles Generator

Xem bản tiếng Việt tại đây.

Screenshots

Click to view screenshots

Here are some screenshots showcasing the application's current features:


Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later	Caption later

Caption later	Caption later

A comprehensive web application for auto-subtitling videos and audio, translating SRT files, generating AI narration with voice cloning, creating background images and music, and rendering professional subtitled videos. Designed for content creators, educators, and general users who need high-quality subtitle generation and video production capabilities.

What's included

There's one OSG — no Lite/Full split. The base install is small, and the heavy voice-cloning and local transcription engines (F5-TTS, Chatterbox, NVIDIA Parakeet) install on demand from inside the app (Settings → Voice & transcription engines) — a one-time ~3 GB GPU download per engine, so you only download what you use. The only variant is whether you run OSG locally or on a hosted/Vercel deployment (no local backend → no rendering, downloads, or local engines).

Feature	OSG (local)	OSG Vercel (hosted)
AI Subtitle Generation	✅ Gemini, + on-demand NVIDIA Parakeet (local ASR)	✅ Gemini AI transcription
Video Sources	✅ YouTube, Douyin/TikTok, 1000+ platforms + Upload	Upload only
Subtitle Editor	✅ Visual timeline, waveform, real-time preview	✅ Visual timeline, waveform, real-time preview
Translation	✅ Multi-language with context awareness	✅ Multi-language with context awareness
Video Rendering	✅ GPU-accelerated with Remotion	❌ Not available
Background Music Generation	✅ AI music with Lyria	✅ AI music with Lyria
Basic TTS	✅ Gemini Live API, Edge TTS, Google TTS	❌ Not available
Voice Cloning	✅ F5-TTS, Chatterbox (install on demand)	❌ Not available
Install size	~2-3 GB base (+ ~3 GB per heavy engine you install)	N/A (hosted)
GPU Requirements	Any GPU for rendering; GPU recommended for voice/Parakeet (CPU fallback)	None

Quick Installation Guide

Installation on Windows

Go to Releases and download the latest OSG_installer_Windows.bat.
Open the downloaded .bat file and follow the instructions (app size will be large if installing with voice cloning feature)

Installation on macOS and Ubuntu

Clone this repo and run the OSG_installer.sh file:

git clone https://github.com/nganlinh4/oneclick-subtitles-generator.git
cd oneclick-subtitles-generator
chmod +x OSG_installer.sh
./OSG_installer.sh

Follow the on-screen instructions (app size will be large if installing with voice cloning feature)

Update or Run Application

Windows

Open OSG_installer_Windows.bat and follow the instructions.

macOS and Ubuntu

Open Terminal and run the OSG_installer.sh file again:
```
./OSG_installer.sh
```
Browser will automatically open at http://localhost:3030

Features

🎬 Video & Audio Processing

Multi-source support: Upload video/audio files, YouTube URLs, Douyin/TikTok links, or search YouTube by title
Format compatibility: Supports MP4, AVI, MOV, WebM, WMV, MP3, WAV, AAC, FLAC, and more
Quality scanning: Intelligent video quality detection with cookie-based authentication for premium content
Video compatibility checking: Automatic format conversion for Remotion compatibility

🤖 AI-Powered Subtitle Generation

Google Gemini AI: Uses latest Gemini 2.5 models (Flash, Pro) for accurate transcription
NVIDIA Parakeet (local, optional): On-device ASR for fast, private transcription once its engine is installed (Settings → Voice & transcription engines). Choose the "NVIDIA Parakeet" method in the subtitle generation dialog. Unified with the same lifecycle, retries, and progress UI as Gemini.
Multi-language support: Generate subtitles in multiple languages with high accuracy
Parallel processing: Handles long videos (15+ minutes) with intelligent segmentation
Custom prompts: Configurable transcription prompts for specialized content
Retry mechanisms: Smart retry with different models for failed segments

✏️ Advanced Subtitle Editing

Visual timeline editor: Drag-and-drop timing adjustments with waveform visualization
Real-time preview: Live subtitle synchronization with video playback
Sticky timing: Batch adjust multiple subtitles simultaneously
Text editing: Direct text modification with undo/redo functionality
Merge & split: Combine adjacent subtitles or split long ones
Format support: Export to SRT, JSON, or custom formats

🗣️ AI Voice Narration

F5-TTS integration: State-of-the-art voice cloning technology
Chatterbox TTS: High-quality text-to-speech with voice conversion
Edge TTS & Google TTS: Multiple TTS engine options
Reference audio: Upload, record, or extract voice samples from videos
Multi-audio tracks: Combine original audio with AI-generated narration
Volume controls: Independent audio level management

🌍 Translation & Localization

Multi-language translation: Translate subtitles to any language while preserving timing
Custom formatting: Configurable output formats with brackets, delimiters, and chains
Batch processing: Translate multiple subtitle sets simultaneously
Context awareness: AI-powered translation with video context understanding

🎹 Background Music Generation

AI-generated background music with prompt-based control
MIDI playback and control support (promptdj-midi)
Simple export for use in video rendering

🎥 Professional Video Rendering

Remotion integration: GPU-accelerated video rendering with hardware optimization
Multi-resolution support: 360p to 8K output with automatic aspect ratio detection
Subtitle customization: Extensive styling options including fonts, colors, effects, and animations
Multi-audio support: Combine original video audio with AI narration tracks
Background integration: Use generated images or video backgrounds
Render queue: Batch processing with progress tracking

How to Use

1. Select Your Content Source

File Upload: Drag & drop or browse for video/audio files
YouTube: Paste URL or search by title with thumbnail preview
Douyin/TikTok: Paste URL for automatic extraction
Other platforms: Use any supported video URL

2. Generate AI Subtitles

Choose your preferred engine:
- Gemini (cloud) for convenience and strong accuracy
- NVIDIA Parakeet (local) for on-device, privacy-friendly transcription (install on demand)
Pick your Gemini model (2.5 Flash/Pro recommended) or Parakeet strategy (sentence/word/char)
Configure custom prompts for specialized content
Click "Generate timed subtitles" and monitor progress
Long videos are automatically processed in parallel segments

3. Edit & Refine Subtitles

Visual timeline: Drag timing handles with waveform visualization
Real-time preview: See changes instantly synchronized with video
Text editing: Click to edit subtitle content directly
Batch operations: Use sticky timing for multiple subtitle adjustments
Advanced tools: Merge, split, insert, or delete subtitle segments

4. Translate Content (Optional)

Select target languages for translation
Configure output formatting (brackets, delimiters, chains)
Use context-aware AI translation with video understanding
Preserve original timing while adapting text

5. Generate AI Narration (Optional)

- **Set up reference audio**: Upload, record, or extract from video
- **Choose TTS engine**: F5-TTS (voice cloning), Chatterbox, Edge TTS, or Google TTS
- **Configure voice settings**: Adjust speed, pitch, and style parameters
- **Generate narration**: Create AI voice for original or translated subtitles

6. Create Background Music (Optional)

Open the Background Music panel
Enter a prompt or choose presets, then generate
Preview and adjust via MIDI controls; export for rendering

7. Render Professional Videos

Open video renderer: Access the integrated Remotion-based renderer
Customize subtitles: Extensive styling options (fonts, colors, effects, animations)
Configure audio: Balance original video audio with AI narration
Set output quality: Choose resolution from 360p to 8K
Render with GPU acceleration: Hardware-optimized processing for fast output

8. Export & Download

Subtitle files: SRT, JSON, or custom formats
Audio files: Generated narration in various formats
Rendered videos: Professional subtitled videos with custom styling

Configuration

Access settings via the gear icon in the top-right corner:

API Keys: Gemini (required), YouTube (optional for search)
AI Models: Choose between Gemini 2.5 Flash, Pro, or experimental models
Processing Method: Switch between Gemini (cloud) and NVIDIA Parakeet (local ASR, install on demand)
Languages: English, Vietnamese, Korean interface support
Video Processing: Segment duration, quality preferences, cookie management
TTS Engines: F5-TTS, Chatterbox, Gemini Live API, Edge TTS, or Google TTS selection
Interface: Dark/light themes, time format, waveform visualization
Cache Management: Clear caches and monitor storage usage

Technical Stack

Frontend: React 18, Styled Components, i18next
Video Rendering: Remotion 4 with GPU acceleration (Vulkan/OpenGL)
Backend: Node.js/Express, Python Flask, FastAPI
AI Integration: Google Gemini API, F5-TTS, Chatterbox TTS , NVIDIA Parakeet (local ASR)
Audio/Video: FFmpeg, Web Audio API, yt-dlp, Puppeteer
Performance: React Window virtualization, multi-level caching, hardware acceleration

Performance Features

GPU Acceleration: Hardware-accelerated video rendering with Vulkan/OpenGL
Virtualized UI: Only renders visible elements for optimal performance with long videos
Parallel Processing: Multi-core subtitle generation and video processing
Smart Caching: Multi-layer cache system for subtitles, videos, and generated content
Optimized Timeline: Hardware-accelerated canvas visualization with adaptive rendering
Efficient Memory: Automatic cleanup and smart resource management

Acknowledgements

🎯 Core Technologies

React - Modern UI framework with hooks and context
Remotion - Programmatic video creation and rendering
Node.js - JavaScript runtime for backend services
Express - Web application framework for Node.js

🤖 AI & Machine Learning

Google Gemini AI - Advanced language models for transcription and image generation
F5-TTS - State-of-the-art voice cloning technology
Chatterbox - High-quality TTS and voice conversion
Microsoft Edge TTS - Neural text-to-speech service
Google Text-to-Speech - Cloud-based speech synthesis
NVIDIA Parakeet (local ASR)

🎬 Video & Audio Processing

FFmpeg - Comprehensive multimedia framework
yt-dlp - Universal video downloader for 1000+ platforms
Puppeteer - Headless Chrome control for web scraping

🎨 UI & Visualization

Styled Components - CSS-in-JS styling solution
React Router - Declarative routing for React
React Window - Efficient virtualization for large lists
React Icons - Popular icon libraries for React
HTML5 Canvas - Hardware-accelerated timeline visualization

🌐 Internationalization & Accessibility

i18next - Internationalization framework
React i18next - React integration for i18next
Material 3 Expressive - Modern design principles and accessibility standards

🔧 Development & Build Tools

TypeScript - Type-safe JavaScript development
Create React App - React application scaffolding
Concurrently - Multi-service development environment
Cross-env - Cross-platform environment variables

📦 Package Management & Deployment

npm - Package manager for JavaScript
uv - Fast Python package installer and resolver
Python - Backend services for AI processing

🙏 Special Thanks

Open source community for maintaining these incredible tools
Google DeepMind for advancing AI accessibility
Remotion team for revolutionizing programmatic video creation
F5-TTS contributors for open-source voice cloning technology
All beta testers and contributors who helped improve this application

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Name		Name	Last commit message	Last commit date
.roo		.roo
additional_docs		additional_docs
asr_services		asr_services
chatterbox-fastapi		chatterbox-fastapi
electron-logs		electron-logs
electron		electron
models/chatterbox_weights		models/chatterbox_weights
parakeet_wrapper		parakeet_wrapper
promptdj-midi		promptdj-midi
public		public
readme_assets		readme_assets
scripts		scripts
server		server
src		src
utils		utils
video-renderer		video-renderer
.eslintignore		.eslintignore
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
.npmrc		.npmrc
CLAUDE.md		CLAUDE.md
OSG_installer.sh		OSG_installer.sh
OSG_installer_Windows.bat		OSG_installer_Windows.bat
README.md		README.md
README.vi.md		README.vi.md
SVG_REPLACEMENT_GUIDE.md		SVG_REPLACEMENT_GUIDE.md
app.js		app.js
dev-server.js		dev-server.js
install-base.js		install-base.js
install-yt-dlp.js		install-yt-dlp.js
narration-constraints.txt		narration-constraints.txt
package-lock.json		package-lock.json
package.json		package.json
server.js		server.js
setup-narration.js		setup-narration.js
setup-workspaces.js		setup-workspaces.js
update-narration-packages.js		update-narration-packages.js
uv.toml		uv.toml

Latest commit

History

Folders and files

Repository files navigation

One-Click Subtitles Generator

Screenshots

What's included

Quick Installation Guide

Installation on Windows

Installation on macOS and Ubuntu

Update or Run Application

Windows

macOS and Ubuntu

Features

🎬 Video & Audio Processing

🤖 AI-Powered Subtitle Generation

✏️ Advanced Subtitle Editing

🗣️ AI Voice Narration

🌍 Translation & Localization

🎹 Background Music Generation

🎥 Professional Video Rendering

How to Use

1. Select Your Content Source

2. Generate AI Subtitles

3. Edit & Refine Subtitles

4. Translate Content (Optional)

5. Generate AI Narration (Optional)

6. Create Background Music (Optional)

7. Render Professional Videos

8. Export & Download

Configuration

Technical Stack

Performance Features

Acknowledgements

🎯 Core Technologies

🤖 AI & Machine Learning

🎬 Video & Audio Processing

🎨 UI & Visualization

🌐 Internationalization & Accessibility

🔧 Development & Build Tools

📦 Package Management & Deployment

🙏 Special Thanks

License

About

Resources

Stars

Watchers

Forks

Releases

Used by

Contributors

Languages