A powerful, privacy-focused subtitle editor that runs entirely in your browser
Proudly sponsored by AvalAI
Subtitle Flow is a professional-grade subtitle editor that operates 100% in your web browser. No backend servers, no data uploads, no privacy concerns – just powerful subtitle editing at your fingertips.
- 🔒 Complete Privacy - All processing happens locally in your browser.
- 🔑 Bring Your Own API Key - You control your API keys (Google AI, OpenAI, Groq, AvalAI); they are stored locally in your browser and never sent to our servers.
- ⚡ Lightning Fast - No network latency or server delays for core editing.
- 🌐 Works Offline - Edit subtitles anywhere, anytime (AI features require an internet connection).
- 💰 Free Forever - No subscriptions or hidden costs for the editor. AI features depend on your API provider's pricing.
- 📁 Multi-format Support - Import/export SRT, VTT, and more
- ✏️ Intuitive Timeline Editor - Precise timing adjustments with visual cues (planned feature: waveform)
- 🎥 Integrated Media Player - Real-time preview and synchronization
- 🔄 Undo/Redo - Never lose your work with comprehensive history (planned feature)
- 🤖 Automatic Transcription (Full Media - Option 2) - Generate timestamped subtitles for your entire media file using specialized models from OpenAI (Whisper), Groq (Whisper Large v3, v3-turbo), or AvalAI (Whisper-based). Configured via "Timestamp Task" settings.
- ⚡ Multi-Process Transcription (Option 3) - A two-stage process for enhanced accuracy. First, generates full timestamped subtitles (like Option 2). Then, refines the text of each segment in parallel using models optimized for text generation (configured via "Cue/Slice Task" settings).
- 🚀 Google AI (Gemini) for Cue/Slice Transcription - Leverage Google's Gemini models (via your Google API key) for regenerating specific subtitle segments in the editor. Configured via "Cue/Slice Task" settings.
- ⚡ Groq API Support - Utilize fast Whisper models (
whisper-large-v3,whisper-large-v3-turbo) for both full media transcription (Timestamp Task) and individual segment regeneration (Cue/Slice Task).
- 🎨 Dark/Light Themes - Comfortable editing in any environment
- 📱 Responsive Design - Works on desktop, tablet, and mobile
- ⌨️ Keyboard Shortcuts - Speed up your workflow (view with
?or via Settings)
- Visit subtitle-flow.moaminsharifi.com (or your deployment URL)
- Upload your video or audio file
- Start editing or generate subtitles with AI (requires API key(s) in Settings)
- Export your finished subtitles
No installation, no sign-up, no hassle!
- Modern web browser (Chrome, Firefox, Safari, Edge)
- 4GB RAM recommended for smooth video playback
- Internet connection required for AI transcription features
📸 Screenshots (click to expand)
The main editing interface with timeline and preview
Clean onboarding experience
Automatic subtitle generation interface
Configure API keys and preferences
Helpful tips and shortcuts
Advanced debugging tools
To use the AI-powered transcription features, you'll need API keys from the respective providers. Configure these in Settings:
- Google AI (for Gemini models):
- Used for: Cue/Slice (segment) transcription, either directly ("Google AI" provider) or via "AvalAI (Gemini Base)" provider.
- Visit Google AI Studio or Google Cloud Console.
- Create an account or sign in.
- Generate a new API key.
- Copy and paste it into Subtitle Flow settings (Google AI API Key field).
- OpenAI:
- Used for: Full media transcription (Whisper) and Cue/Slice transcription (
gpt-4o-transcribe,gpt-4o-mini-transcribe,whisper-1). - Visit OpenAI Platform
- Create an account or sign in.
- Navigate to API Keys section.
- Generate a new API key.
- Copy and paste it into Subtitle Flow settings (OpenAI API Key field).
- Used for: Full media transcription (Whisper) and Cue/Slice transcription (
- Groq:
- Used for: Full media transcription and Cue/Slice transcription (Whisper Large v3 models like
whisper-large-v3,whisper-large-v3-turbo). - Visit GroqCloud Console
- Create an account or sign in.
- Create a new API key.
- Copy and paste it into Subtitle Flow settings (Groq API Key field).
- Used for: Full media transcription and Cue/Slice transcription (Whisper Large v3 models like
- AvalAI:
- For OpenAI-compatible models (Whisper for full transcription,
gpt-4o-transcribe, etc. for cue/slice):- Visit AvalAI Dashboard
- Generate or copy your AvalAI API key.
- Paste into Subtitle Flow settings (AvalAI API Key field).
- Select "AvalAI (OpenAI Whisper/GPT)" as the provider in AI Settings for the respective task.
- For Gemini-based models (for cue/slice):
- You will use your Google AI API Key (see step 1).
- In Subtitle Flow settings, select "AvalAI (Gemini Base)" as the LLM Provider for Cue/Slice Task and ensure your Google API Key is entered.
- For OpenAI-compatible models (Whisper for full transcription,
🔒 Privacy Note: Your API keys are stored locally in your browser's localStorage and are only used to communicate directly with the respective API provider's servers. They never pass through our systems.
🌍 View all 60+ supported languages
| Popular | European | Asian | Other |
|---|---|---|---|
| English | German | Chinese | Arabic |
| Spanish | French | Japanese | Hebrew |
| Portuguese | Italian | Korean | Turkish |
| Russian | Polish | Hindi | Persian |
| Dutch | Vietnamese | Swahili | |
| Swedish | Thai | ||
| Norwegian | Indonesian | ||
| Danish | Malay | ||
| Finnish | Bengali | ||
| Greek | Tamil | ||
| Ukrainian | Urdu |
And many more! Select "Auto-detect" for automatic language detection.
- Keyboard Shortcuts: Press
?in the editor (or access via Settings) to view all shortcuts - Frame-Perfect Timing: Use player controls and precise input in the editor for timing.
- Batch Operations: Select multiple subtitles with
Shift+Click(planned feature for advanced editing) - Quick Export:
Ctrl/Cmd + Sto save your work (browser-dependent, exporting is manual via Export step)
- Node.js 18+ and npm/yarn
- Git
# Clone the repository
git clone https://github.com/moaminsharifi/subtitle-flow.git
cd subtitle-flow
# Install dependencies
npm install
# Start development server
npm run dev
# Build for production
npm run build- Frontend: React (Next.js)
- Styling: Tailwind CSS, ShadCN UI
- AI Orchestration: Genkit
- AI Integration: Google AI API, OpenAI API, Groq API, AvalAI API
- Media Processing: Web Audio API, WebCodecs API (planned)
- Storage: Browser localStorage (for settings), IndexedDB (planned for project persistence)
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Google AI for the Gemini models and Genkit
- OpenAI for the Whisper and GPT models
- Groq for providing API access to fast language models
- AvalAI for their transcription services and support
- The open-source community for inspiration and tools
- All our contributors and users