README.md

metadata

title: MV Subtitle Generator & Reviewer
emoji: 📝
colorFrom: indigo
colorTo: purple
sdk: docker
sdk_version: 20.10.x
app_file: app.py
pinned: false
app_port: 7860

MV Subtitle Generator & Reviewer

A powerful, context-aware subtitle generation and cleaning tool. It combines industry-standard transcription with an intelligent LLM-based review system to capture names, technical jargon, and grammar that standard tools miss.

🚀 Features

• Context-Aware AI: Provides subject matter and speaker names to the AI for highly accurate transcription correction.
• Smart Auto-Tidy: Automatically fixes high-confidence errors (typos, specific homophones) instantly.
• Interactive Review:
  • Synced Media Player: Watch your video (or listen to audio) in real-time while editing.
  • Click-to-Seek: Click any subtitle segment to jump the audio to that exact moment.
  • Inline Editing: Fix any text manually with a simple click.
• Format Support: Works with MP3 (Audio) and MP4 (Video).

📚 Documentation

We have detailed guides to help you get the most out of the application:

• User Guide: A complete walkthrough of the interface, from upload to export.
• AI & Context Features: Learn how to use the "Context" field to get perfect results.
• Deployment Guide: How to host this application on Hugging Face Spaces.

🛠️ Quick Start

1. Run the Server: npm run dev
2. Open Browser: Go to http://localhost:5000
3. Upload: Drag & drop your MP3/MP4 file and provide a short context description.
4. Review: Use the interface to accept AI suggestions or make manual edits.
5. Export: Download your finished .srt file.

Tech Stack

• Frontend: React, TanStack Query, ShadCN UI, Tailwind CSS.
• Backend: Node.js (Express).
• AI/ML: Hugging Face Inference API (Mistral-7B-Instruct-v0.2).