subtitlekit 0.1.0__tar.gz

subtitlekit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SubtitleKit Contributors
+
+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.

subtitlekit-0.1.0/MANIFEST.in

@@ -0,0 +1,15 @@
+# MANIFEST.in - Include additional files in distribution
+
+include LICENSE
+include README.md
+include pyproject.toml
+include requirements.txt
+
+# Include all locale files
+recursive-include src/subtitlekit/ui/locales *.json
+
+# Exclude compiled files and caches
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude *.so
+global-exclude *~

subtitlekit-0.1.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: subtitlekit
+Version: 0.1.0
+Summary: Subtitle processing toolkit: merge, sync, fix overlaps, and apply corrections
+Author-email: angelospk <haroldpoigr@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/angelospk/subtitlekit
+Project-URL: Repository, https://github.com/angelospk/subtitlekit
+Project-URL: Issues, https://github.com/angelospk/subtitlekit/issues
+Keywords: subtitles,srt,synchronization,translation,processing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pysrt>=1.1.2
+Requires-Dist: chardet>=5.0.0
+Requires-Dist: ffsubsync>=0.4.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Provides-Extra: ui
+Requires-Dist: ipywidgets>=8.0.0; extra == "ui"
+Dynamic: license-file
+
+# SubtitleKit - Subtitle Processing Toolkit
+
+[![PyPI version](https://badge.fury.io/py/subtitlekit.svg)](https://badge.fury.io/py/subtitlekit)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Comprehensive Python library and desktop application for subtitle processing, synchronization, and correction.
+
+## ✨ Features
+
+- **Merge & Sync**: Combine subtitle files with automatic synchronization
+- **Fix Overlaps**: Detect and correct timing issues and overlaps  
+- **Apply Corrections**: Apply text corrections from JSON files
+- **LLM Integration**: Generate optimized JSON for translation workflows
+- **Desktop App**: Cross-platform GUI (Windows, macOS, Linux)
+- **Colab Ready**: Works seamlessly in Google Colab notebooks
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install subtitlekit
+```
+
+### Google Colab
+
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1lvdSX7aNhNknLs9laxfTeKdK_xNUvLOY?usp=sharing)
+
+```python
+# Install
+!pip install subtitlekit
+
+# Launch UI
+from subtitlekit.ui import show_ui
+show_ui(lang='en')  # or 'el' for Greek
+```
+
+### As a Library
+
+```python
+from subtitlekit import merge_subtitles, fix_overlaps, apply_corrections
+
+# Merge subtitle files
+merge_subtitles("original.srt", ["helper.srt"], "output.json")
+
+# Fix timing overlaps
+fix_overlaps("input.srt", "reference.srt", "fixed.srt")
+
+# Apply corrections from JSON
+apply_corrections("input.srt", "corrections.json", "output.srt")
+```
+
+### CLI Usage
+
+```bash
+# Merge subtitles
+subtitlekit merge --original original.srt --helper helper.srt --output output.json
+
+# Fix overlaps
+subtitlekit overlaps --input input.srt --reference ref.srt --output fixed.srt
+
+# Apply corrections
+subtitlekit corrections --input input.srt --corrections fixes.json --output corrected.srt
+```
+
+### Desktop App
+
+Download the standalone application from [Releases](https://github.com/angelospk/subtitlekit/releases).
+
+**Or launch programmatically:**
+```python
+python -m subtitlekit.ui.desktop
+```
+
+## 📖 Documentation
+
+### Merge Subtitles
+
+Combines original subtitle file with one or more helper files (different languages) to create JSON output optimized for LLM translation workflows.
+
+```bash
+subtitlekit merge \
+  --original movie.srt \
+  --helper helpful_en.srt \
+  --helper helpful_pt.srt \
+  --output for_translation.json \
+  --skip-sync  # optional: skip ffsubsync
+```
+
+**Output format:**
+```json
+{
+  "id": 1,
+  "t": "00:00:11,878 --> 00:00:16,130",
+  "trans": "Original text to translate",
+  "h1": "Helper text (language 1)",
+  "h2": "Helper text (language 2)"
+}
+```
+
+### Fix Overlaps
+
+Detects and corrects timing issues:
+- Overlapping timestamps
+- Out-of-order entries
+- Unreasonable durations
+- Duplicate timings
+
+```bash
+subtitlekit overlaps \
+  --input problematic.srt \
+  --reference correct_timings.srt \
+  --output fixed.srt \
+  --window 5
+```
+
+### Apply Corrections
+
+Apply text corrections from JSON file:
+
+```bash
+subtitlekit corrections \
+  --input subtitle.srt \
+  --corrections fixes.json \
+  --output corrected.srt
+```
+
+**Corrections JSON format:**
+```json
+[
+  {
+    "id": 1,
+    "rx": "text to find",
+    "sb": "replacement text",
+    "rate": 8,
+    "type": "grammar"
+  }
+]
+```
+
+## 🌍 I18n Support
+
+Desktop and Colab UIs support:
+- 🇬🇧 English
+- 🇬🇷 Greek (Ελληνικά)
+
+## 📦 Development
+
+```bash
+# Clone repository
+git clone https://github.com/angelospk/subtitlekit.git
+cd subtitlekit
+
+# Install in development mode
+pip install -e .
+
+# Run tests
+pytest -v
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file.
+
+## 🙏 Credits
+
+Built by [angelospk](https://github.com/angelospk)

subtitlekit-0.1.0/README.md

@@ -0,0 +1,172 @@
+# SubtitleKit - Subtitle Processing Toolkit
+
+[![PyPI version](https://badge.fury.io/py/subtitlekit.svg)](https://badge.fury.io/py/subtitlekit)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Comprehensive Python library and desktop application for subtitle processing, synchronization, and correction.
+
+## ✨ Features
+
+- **Merge & Sync**: Combine subtitle files with automatic synchronization
+- **Fix Overlaps**: Detect and correct timing issues and overlaps  
+- **Apply Corrections**: Apply text corrections from JSON files
+- **LLM Integration**: Generate optimized JSON for translation workflows
+- **Desktop App**: Cross-platform GUI (Windows, macOS, Linux)
+- **Colab Ready**: Works seamlessly in Google Colab notebooks
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install subtitlekit
+```
+
+### Google Colab
+
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1lvdSX7aNhNknLs9laxfTeKdK_xNUvLOY?usp=sharing)
+
+```python
+# Install
+!pip install subtitlekit
+
+# Launch UI
+from subtitlekit.ui import show_ui
+show_ui(lang='en')  # or 'el' for Greek
+```
+
+### As a Library
+
+```python
+from subtitlekit import merge_subtitles, fix_overlaps, apply_corrections
+
+# Merge subtitle files
+merge_subtitles("original.srt", ["helper.srt"], "output.json")
+
+# Fix timing overlaps
+fix_overlaps("input.srt", "reference.srt", "fixed.srt")
+
+# Apply corrections from JSON
+apply_corrections("input.srt", "corrections.json", "output.srt")
+```
+
+### CLI Usage
+
+```bash
+# Merge subtitles
+subtitlekit merge --original original.srt --helper helper.srt --output output.json
+
+# Fix overlaps
+subtitlekit overlaps --input input.srt --reference ref.srt --output fixed.srt
+
+# Apply corrections
+subtitlekit corrections --input input.srt --corrections fixes.json --output corrected.srt
+```
+
+### Desktop App
+
+Download the standalone application from [Releases](https://github.com/angelospk/subtitlekit/releases).
+
+**Or launch programmatically:**
+```python
+python -m subtitlekit.ui.desktop
+```
+
+## 📖 Documentation
+
+### Merge Subtitles
+
+Combines original subtitle file with one or more helper files (different languages) to create JSON output optimized for LLM translation workflows.
+
+```bash
+subtitlekit merge \
+  --original movie.srt \
+  --helper helpful_en.srt \
+  --helper helpful_pt.srt \
+  --output for_translation.json \
+  --skip-sync  # optional: skip ffsubsync
+```
+
+**Output format:**
+```json
+{
+  "id": 1,
+  "t": "00:00:11,878 --> 00:00:16,130",
+  "trans": "Original text to translate",
+  "h1": "Helper text (language 1)",
+  "h2": "Helper text (language 2)"
+}
+```
+
+### Fix Overlaps
+
+Detects and corrects timing issues:
+- Overlapping timestamps
+- Out-of-order entries
+- Unreasonable durations
+- Duplicate timings
+
+```bash
+subtitlekit overlaps \
+  --input problematic.srt \
+  --reference correct_timings.srt \
+  --output fixed.srt \
+  --window 5
+```
+
+### Apply Corrections
+
+Apply text corrections from JSON file:
+
+```bash
+subtitlekit corrections \
+  --input subtitle.srt \
+  --corrections fixes.json \
+  --output corrected.srt
+```
+
+**Corrections JSON format:**
+```json
+[
+  {
+    "id": 1,
+    "rx": "text to find",
+    "sb": "replacement text",
+    "rate": 8,
+    "type": "grammar"
+  }
+]
+```
+
+## 🌍 I18n Support
+
+Desktop and Colab UIs support:
+- 🇬🇧 English
+- 🇬🇷 Greek (Ελληνικά)
+
+## 📦 Development
+
+```bash
+# Clone repository
+git clone https://github.com/angelospk/subtitlekit.git
+cd subtitlekit
+
+# Install in development mode
+pip install -e .
+
+# Run tests
+pytest -v
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file.
+
+## 🙏 Credits
+
+Built by [angelospk](https://github.com/angelospk)

subtitlekit-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "subtitlekit"
+version = "0.1.0"
+description = "Subtitle processing toolkit: merge, sync, fix overlaps, and apply corrections"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "angelospk", email = "haroldpoigr@gmail.com"}
+]
+keywords = ["subtitles", "srt", "synchronization", "translation", "processing"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Text Processing",
+]
+
+dependencies = [
+    "pysrt>=1.1.2",
+    "chardet>=5.0.0",
+    "ffsubsync>=0.4.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+]
+ui = [
+    "ipywidgets>=8.0.0",  # For Colab UI
+]
+
+[project.urls]
+Homepage = "https://github.com/angelospk/subtitlekit"
+Repository = "https://github.com/angelospk/subtitlekit"
+Issues = "https://github.com/angelospk/subtitlekit/issues"
+
+[project.scripts]
+subtitlekit = "subtitlekit.cli.main:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+subtitlekit = ["ui/locales/*.json"]

subtitlekit-0.1.0/requirements.txt

@@ -0,0 +1,4 @@
+ffsubsync>=0.4.0
+pysrt>=1.1.2
+pytest>=7.0.0
+chardet>=5.0.0

subtitlekit-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

subtitlekit-0.1.0/src/subtitlekit/__init__.py

@@ -0,0 +1,27 @@
+"""
+SubtitleKit - Subtitle Processing Toolkit
+
+A comprehensive library for subtitle processing, synchronization, and correction.
+"""
+
+__version__ = "0.1.0"
+
+from .tools import merge_subtitles, fix_overlaps, apply_corrections
+from .core import (
+    detect_file_encoding,
+    read_srt_with_fallback,
+    preprocess_srt_file,
+    clean_subtitle_file,
+)
+
+__all__ = [
+    # Main functions
+    'merge_subtitles',
+    'fix_overlaps',
+    'apply_corrections',
+    # Utilities
+    'detect_file_encoding',
+    'read_srt_with_fallback',
+    'preprocess_srt_file',
+    'clean_subtitle_file',
+]

subtitlekit-0.1.0/src/subtitlekit/cli/__init__.py

@@ -0,0 +1,3 @@
+"""
+SubtitleKit CLI - Command line interface
+"""

subtitlekit-0.1.0/src/subtitlekit/cli/main.py

@@ -0,0 +1,154 @@
+#!/usr/bin/env python3
+"""
+SubtitleKit CLI - Unified command-line interface
+
+Usage:
+    subtitlekit merge --original FILE --helper FILE [--helper FILE ...] --output FILE
+    subtitlekit overlaps --input FILE --reference FILE --output FILE [--window N]
+    subtitlekit corrections --input FILE --corrections FILE --output FILE
+"""
+
+import argparse
+import sys
+from pathlib import Path
+
+
+def cmd_merge(args):
+    """Merge subtitle files"""
+    from subtitlekit.tools.matcher import process_subtitles
+    from subtitlekit.core.cleaner import clean_subtitle_file
+    import json
+    import os
+    
+    print(f"Processing subtitles...")
+    print(f"  Original: {args.original}")
+    for i, helper in enumerate(args.helper, 1):
+        print(f"  Helper {i}: {helper}")
+    print(f"  Output: {args.output}")
+    
+    if args.skip_sync:
+        print("  Skipping synchronization")
+    
+    # Clean subtitle formatting
+    print("  Cleaning subtitle formatting...")
+    cleaned_original = clean_subtitle_file(args.original)
+    
+    try:
+        # Process with cleaned file
+        results = process_subtitles(
+            cleaned_original,
+            args.helper,
+            skip_sync=args.skip_sync
+        )
+    finally:
+        # Clean up temporary file
+        if os.path.exists(cleaned_original):
+            os.unlink(cleaned_original)
+    
+    # Write output
+    with open(args.output, 'w', encoding='utf-8') as f:
+        json.dump(results, f, ensure_ascii=False, indent=2)
+    
+    print(f"\n✅ Success! Processed {len(results)} subtitle entries.")
+    print(f"Output written to: {args.output}")
+
+
+def cmd_overlaps(args):
+    """Fix timing overlaps"""
+    from subtitlekit.tools.overlaps import fix_problematic_timings
+    
+    print(f"Fixing overlaps and timing issues...")
+    print(f"  Input: {args.input}")
+    print(f"  Reference: {args.reference}")
+    print(f"  Output: {args.output}")
+    print(f"  Window: {args.window}")
+    
+    fix_problematic_timings(
+        args.input,
+        args.reference,
+        args.output,
+        window=args.window,
+        preprocess=args.preprocess
+    )
+    
+    print(f"\n✅ Done! Fixed file saved to: {args.output}")
+
+
+def cmd_corrections(args):
+    """Apply corrections from JSON"""
+    from subtitlekit.tools.corrections import apply_corrections_from_file
+    
+    print(f"Applying corrections...")
+    print(f"  Input: {args.input}")
+    print(f"  Corrections: {args.corrections}")
+    print(f"  Output: {args.output}")
+    
+    stats = apply_corrections_from_file(
+        args.input,
+        args.corrections,
+        args.output,
+        verbose=not args.quiet
+    )
+    
+    if args.quiet:
+        print(f"✅ Applied {stats['applied']}/{stats['total']} corrections")
+
+
+def main():
+    """Main CLI entry point"""
+    parser = argparse.ArgumentParser(
+        prog='subtitlekit',
+        description='Subtitle processing toolkit: merge, sync, fix, and correct subtitles'
+    )
+    
+    subparsers = parser.add_subparsers(dest='command', help='Commands')
+    
+    # Merge command
+    merge_parser = subparsers.add_parser('merge', help='Merge and synchronize subtitle files')
+    merge_parser.add_argument('--original', required=True, help='Original subtitle file (to translate)')
+    merge_parser.add_argument('--helper', action='append', required=True, 
+                             help='Helper subtitle file (can be used multiple times)')
+    merge_parser.add_argument('--output', required=True, help='Output JSON file')
+    merge_parser.add_argument('--skip-sync', action='store_true',
+                             help='Skip ffsubsync synchronization')
+    merge_parser.set_defaults(func=cmd_merge)
+    
+    # Overlaps command
+    overlaps_parser = subparsers.add_parser('overlaps', help='Fix timing overlaps and issues')
+    overlaps_parser.add_argument('--input', required=True, help='Input subtitle file')
+    overlaps_parser.add_argument('--reference', required=True, help='Reference subtitle file')
+    overlaps_parser.add_argument('--output', required=True, help='Output subtitle file')
+    overlaps_parser.add_argument('--window', type=int, default=5, 
+                                help='Context window for matching (default: 5)')
+    overlaps_parser.add_argument('--preprocess', action='store_true',
+                                help='Preprocess input file first')
+    overlaps_parser.set_defaults(func=cmd_overlaps)
+    
+    # Corrections command
+    corrections_parser = subparsers.add_parser('corrections', help='Apply corrections from JSON')
+    corrections_parser.add_argument('--input', required=True, help='Input subtitle file')
+    corrections_parser.add_argument('--corrections', required=True, help='Corrections JSON file')
+    corrections_parser.add_argument('--output', required=True, help='Output subtitle file')
+    corrections_parser.add_argument('--quiet', '-q', action='store_true', 
+                                   help='Quiet mode (minimal output)')
+    corrections_parser.set_defaults(func=cmd_corrections)
+    
+    # Parse and execute
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        return 1
+    
+    try:
+        args.func(args)
+        return 0
+    except Exception as e:
+        print(f"\n❌ Error: {e}", file=sys.stderr)
+        if '--verbose' in sys.argv:
+            raise
+        return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())

subtitlekit-0.1.0/src/subtitlekit/core/__init__.py

@@ -0,0 +1,13 @@
+"""
+SubtitleKit Core - Encoding utilities
+"""
+from .encoding import *
+from .preprocessor import *
+from .cleaner import *
+
+__all__ = [
+    'detect_file_encoding',
+    'read_srt_with_fallback',
+    'preprocess_srt_file',
+    'clean_subtitle_file',
+]