SRT Timestamp Fixer

A lightweight, standalone toolkit for fixing malformed SRT subtitle timestamps. Available as Command Line Interface (CLI), Desktop GUI, Web Application, and Windows Executables (.exe).

---

🚀 Why This Tool?

Modern workflows often generate subtitles using Large Language Models (LLMs) and other automated systems. However, these outputs frequently contain inconsistent or malformed SRT timestamps—missing hours, missing arrows, or non-standard formats.

While creating YouTube videos, I personally faced repeated issues with broken subtitle timestamps. Frustrated by the lack of reliable, user-friendly solutions—and driven by personal necessity—I built SRT Timestamp Fixer as a dedicated, professional tool:

• Reliability: Ensures every SRT file is standardized and compliant, regardless of source.
• Convenience: Provides multiple interfaces (CLI, GUI, Web, Executable) for all user types.
• Efficiency: Saves time for content creators, editors, and developers by automating tedious fixes.
• Portability: Works cross-platform and can be used standalone, without Python if desired.

This tool is designed to streamline subtitle workflows and eliminate manual corrections, making it ideal for anyone working with AI-generated or automated subtitles.

---

✨ Features

• Fix missing hours in timestamps
• Add missing arrows
• Standardize SRT format
• Multiple interfaces: CLI, GUI, Web, Windows Executable (.exe)
• Safe processing (backups, UTF-8)
• Cross-platform (Python 3.6+)

---

⚡ Quick Start

1. Command Line

python src/convert_to_srt.py -i input.srt -o output.srt

---

2. Desktop GUI

Windows: Double-click SRT_Timestamp_Fixer_GUI.exe or src/launch_gui.bat
Linux/macOS: Run src/launch_gui.sh

Desktop GUI: Easily fix SRT files with a user-friendly interface. Select files, preview changes, and process with a click.

---

3. Web Application

Windows: Double-click SRT_Timestamp_Fixer_Web.exe or src/launch_web.bat
Linux/macOS: Run src/launch_web.sh
Open browser at http://localhost:5000

Web App: Fix SRT files directly in your browser. Upload, preview, and download results. Works on any OS.

For more details and troubleshooting, see USER_GUIDE.md.

---

🛠️ Development & Build

1. Clone the repository:

   git clone https://github.com/[YOUR-USERNAME]/srt-timestamp-fixer.git
   cd srt-timestamp-fixer

2. (Optional) Create a virtual environment:

   python -m venv venv
   # Windows:
   venv\Scripts\activate
   # Linux/macOS:
   source venv/bin/activate

3. Install dependencies:

   pip install -r src/requirements.txt

4. Run the web app:

   python src/srt_fixer_web.py

Build Executable (Windows)

pip install pyinstaller
pyinstaller --onefile --windowed src/srt_fixer_web.py

---

🤝 Contributing

See USER_GUIDE.md for usage details and troubleshooting.

To contribute:

1. Fork the repository
2. Create a feature branch
3. Commit and push your changes
4. Open a Pull Request

📄 License

MIT License. See LICENSE.