subtitlekit 0.1.0__tar.gz → 0.1.3.dev0__tar.gz

subtitlekit-0.1.3.dev0/.github/workflows/build-executables.yml

@@ -0,0 +1,74 @@
+name: Build Desktop Executables
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:  # Allow manual trigger
+
+jobs:
+  build:
+    name: Build on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            artifact_name: subtitlekit-linux
+            asset_name: subtitlekit-linux
+          - os: windows-latest
+            artifact_name: SubtitleKit.exe
+            asset_name: subtitlekit-windows.exe
+          - os: macos-latest
+            artifact_name: SubtitleKit
+            asset_name: subtitlekit-macos
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Full history for setuptools-scm version detection
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .
+        pip install pyinstaller
+    
+    - name: Build executable
+      run: |
+        # Build with spec file for better control
+        pyinstaller SubtitleKit.spec
+      shell: bash
+    
+    - name: Verify executable (Non-Windows)
+      if: runner.os != 'Windows'
+      run: |
+        ls -lh dist/
+        file dist/SubtitleKit || true
+    
+    - name: Verify executable (Windows)
+      if: runner.os == 'Windows'
+      run: |
+        dir dist\
+    
+    - name: Upload artifact
+      uses: actions/upload-artifact@v4
+      with:
+        name: ${{ matrix.artifact_name }}
+        path: dist/${{ matrix.artifact_name }}
+        if-no-files-found: error
+    
+    - name: Upload to Release
+      if: github.event_name == 'release'
+      uses: actions/upload-release-asset@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        upload_url: ${{ github.event.release.upload_url }}
+        asset_path: dist/${{ matrix.artifact_name }}
+        asset_name: ${{ matrix.asset_name }}
+        asset_content_type: application/octet-stream

subtitlekit-0.1.3.dev0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,33 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Full history for setuptools-scm version detection
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Publish to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: twine upload dist/*

subtitlekit-0.1.3.dev0/.gitignore

@@ -0,0 +1,31 @@
+# Subtitle files (except test fixtures)
+*.srt
+!test_fixtures/*.srt
+
+# Generated JSON files (except test fixtures and locales)
+*.json
+!test_fixtures/*.json
+!src/subtitlekit/ui/locales/*.json
+
+# Generated version file (created by setuptools-scm)
+src/subtitlekit/_version.py
+
+# Python cache
+__pycache__/
+*.pyc
+.pytest_cache/
+old_code_backup/
+
+# Virtual environment
+venv/
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db

subtitlekit-0.1.3.dev0/BUILD_GUIDE.md

@@ -0,0 +1,77 @@
+# Building Executables Locally
+
+Για να δοκιμάσεις το build process τοπικά πριν το push:
+
+## Quick Build
+
+```bash
+# Install PyInstaller
+pip install pyinstaller
+
+# Build executable (simple)
+pyinstaller --onefile --windowed --name SubtitleKit src/subtitlekit/ui/desktop.py
+
+# Output: dist/SubtitleKit (or SubtitleKit.exe on Windows)
+```
+
+## Advanced Build (με locale files)
+
+```bash
+# Using the spec file
+pyinstaller SubtitleKit.spec
+
+# Test the executable
+./dist/SubtitleKit  # macOS/Linux
+./dist/SubtitleKit.exe  # Windows
+```
+
+## Τι Περιλαμβάνει το Workflow
+
+### Trigger Events:
+- ✅ **On Release**: Αυτόματο build όταν δημιουργείς νέο release στο GitHub
+- ✅ **Manual**: Μπορείς να το τρέξεις χειροκίνητα από το Actions tab
+
+### Builds:
+- 🪟 **Windows**: `subtitlekit-windows.exe`
+- 🍎 **macOS**: `subtitlekit-macos`
+- 🐧 **Linux**: `subtitlekit-linux`
+
+### Output Location:
+Τα executables ανεβαίνουν:
+1. Ως **artifacts** (για testing) - διαθέσιμα για 90 μέρες
+2. Ως **release assets** (για download) - μόνιμα με το release
+
+## Πώς να Δημιουργήσεις Release
+
+```bash
+# 1. Tag the version
+git tag v0.1.0
+git push origin v0.1.0
+
+# 2. Create release on GitHub
+# Στο GitHub UI: Releases → Draft new release → Choose tag v0.1.0
+```
+
+Μόλις δημιουργηθεί το release:
+- ✅ PyPI workflow ανεβάζει στο `pip install subtitlekit`
+- ✅ Build workflow δημιουργεί executables για κάθε OS
+- ✅ Executables ανεβαίνουν αυτόματα στο release
+
+## Testing Builds
+
+```bash
+# After download
+chmod +x subtitlekit-macos  # macOS/Linux only
+./subtitlekit-macos
+
+# Windows - just double click .exe
+```
+
+## Προσοχή σε macOS
+
+Τα unsigned executables μπορεί να δείξουν warning. Ο χρήστης πρέπει:
+```
+Right-click → Open → Open anyway
+```
+
+Για signed executables χρειάζεται Apple Developer account (πληρωμένο).

{subtitlekit-0.1.0/src/subtitlekit.egg-info → subtitlekit-0.1.3.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: subtitlekit
-Version: 0.1.0
+Version: 0.1.3.dev0
 Summary: Subtitle processing toolkit: merge, sync, fix overlaps, and apply corrections
 Author-email: angelospk <haroldpoigr@gmail.com>
 License: MIT

subtitlekit-0.1.3.dev0/README_OLD.md

@@ -0,0 +1,240 @@
+# Subtitle Processing Tools
+
+Εργαλεία Python για επεξεργασία και διόρθωση υποτίτλων.
+
+## Εγκατάσταση
+
+```bash
+# Δημιουργία virtual environment
+python3 -m venv venv
+source venv/bin/activate
+
+# Εγκατάσταση dependencies
+pip install -r requirements.txt
+```
+
+## Εργαλεία
+
+### 1. JSON Generation για LLM Translation
+
+Δημιουργεί JSON από SRT αρχεία για επεξεργασία με LLM.
+
+**Χρήση:**
+```bash
+python main.py --original original.srt --helper helpful.srt --output output.json
+```
+
+**Παράμετροι:**
+- `--original`: Αρχείο υπότιτλου για μετάφραση
+- `--helper`: Βοηθητικό αρχείο υπότιτλου (άλλη γλώσσα)
+- `--output`: Αρχείο εξόδου JSON
+- `--skip-sync`: Παράλειψη συγχρονισμού με ffsubsync (αν είναι ήδη συγχρονισμένο)
+
+**JSON Format:**
+```json
+{
+  "id": 16,
+  "t": "00:02:28,050 --> 00:02:29,385",
+  "trans": "<i>-Det gör jag.</i>\n-Det verkar som...",
+  "h": "Parece que está fazendo\no oposto do seu trabalho,"
+}
+```
+
+---
+
+### 2. Smart Overlap Detection and Correction
+
+Ανιχνεύει και διορθώνει timing προβλήματα στους υποτίτλους.
+
+**Τι διορθώνει:**
+- ✅ Overlapping timings (end_time > next_start_time)
+- ✅ Χρονολογικά προβλήματα (start <= previous_end)
+- ✅ Unreasonable durations (> 60 δευτ., π.χ. typos με ώρες)
+- ✅ Duplicate timings
+
+**Χρήση:**
+```bash
+python fix_overlaps.py \
+  --input greek.srt \
+  --reference original.srt \
+  --output greek_fixed.srt \
+  --window 10
+```
+
+**Παράμετροι:**
+- `--input`: Αρχείο υπότιτλου με προβλήματα
+- `--reference`: Reference αρχείο με σωστά timings
+- `--output`: Αρχείο εξόδου
+- `--window`: Context window για matching (default: 5)
+- `--preprocess`: Καθαρίζει το input αρχείο πρώτα (markdown, duplicates κλπ)
+
+**Πώς λειτουργεί:**
+1. **Ανίχνευση**: Βρίσκει overlaps, chronological issues, unreasonable durations
+2. **Matching**: Ταιριάζει προβληματικές γραμμές με το reference (timing-based)
+3. **Διόρθωση**: Αντικαθιστά μόνο τα λάθος timings
+4. **Deduplication**: Αφαιρεί duplicate timings
+5. **Validation**: Επαληθεύει ότι δεν υπάρχουν προβλήματα
+
+**Αποτελέσματα:**
+```
+Problems found: 12
+Problems fixed: 12
+Duplicates removed: 1
+
+Validation:
+  no_overlaps: ✓ PASS
+  chronological_order: ✓ PASS
+  no_duplicates: ✓ PASS
+```
+
+---
+
+### 3. Text Corrections with JSON
+
+Εφαρμόζει διορθώσεις κειμένου από JSON αρχείο σε SRT.
+
+**Τι διορθώνει:**
+- ✅ Λεξιλόγιο και φυσικότητα
+- ✅ Αργκό και ιδιωματισμούς
+- ✅ Ροή και σύνταξη
+- ✅ Γραμματική και συστολές
+
+**Χρήση:**
+```bash
+python apply_corrections_FIXED.py
+```
+
+**Input Files:**
+- `greek_fixed.srt`: Το SRT αρχείο που θέλουμε να διορθώσουμε
+- `corrections.json`: JSON με τις διορθώσεις
+
+**JSON Format:**
+```json
+{
+  "id": 43,
+  "rx": "δεν έβρισκες στο Λύκειο.",
+  "sb": "Στο σχολείο στέγνωνες.",
+  "rate": 8,
+  "type": "αργκό"
+}
+```
+
+**Πώς λειτουργεί:**
+1. **Global Search**: Αναζητά το `rx` (search text) σε όλα τα subtitles
+2. **Smart Matching**: Δοκιμάζει exact, normalized και newline variants
+3. **Apply**: Αντικαθιστά με το `sb` (replacement text)
+4. **Report**: Αναφέρει ποιες διορθώσεις εφαρμόστηκαν
+
+**Output:**
+- `corrected_greek_fixed_FINAL.srt`: Το διορθωμένο αρχείο
+- Console report με applied/not found corrections
+
+**Αποτελέσματα:**
+```
+✓ ID 43 → Applied at subtitle #42 (offset: -2)
+✓ ID 62 → Applied at subtitle #60 (offset: -2)
+✗ ID 99: NOT FOUND
+
+SUMMARY
+Total corrections: 79
+✓ Applied: 76
+✗ Not found: 3
+```
+
+## Δομή Αρχείων
+
+```
+submerge/
+├── main.py                      # JSON generation για LLM
+├── subsync_matcher.py           # Subtitle matching engine
+├── fix_overlaps.py              # Smart overlap correction 🆕
+├── apply_corrections_FIXED.py   # Text corrections από JSON 🆕
+├── encoding_utils.py            # Robust encoding detection
+├── srt_preprocessor.py          # SRT cleaning utilities
+├── enhanced_matcher.py          # Advanced matching algorithms
+├── corrections.ipynb            # Notebook για corrections (Google Colab)
+├── corrections.json             # Διορθώσεις κειμένου
+├── test_fix_overlaps.py         # Tests για overlap correction
+├── test_subsync_matcher.py      # Tests για matching
+├── test_enhanced_matcher.py     # Tests για enhanced matching
+├── llm_prompt_greek.md          # Οδηγίες για LLM
+├── llm_srt_reading_guide.md     # Guide για reading SRT με notes
+├── LLM_USAGE_EXAMPLE.md         # Παραδείγματα χρήσης
+├── FIX_TIMINGS_GUIDE.md         # Guide για timing correction
+└── requirements.txt             # Dependencies
+```
+
+## Requirements
+
+```bash
+pip install -r requirements.txt
+```
+
+**Dependencies:**
+- `pysrt>=1.1.2` - SRT parsing
+- `pytest>=7.0.0` - Testing
+- `ffsubsync>=0.4.0` - Automatic timing sync (optional για main.py)
+- `chardet>=5.0.0` - Encoding detection
+
+## Testing
+
+```bash
+# Τρέξε όλα τα tests
+pytest -v
+
+# Μόνο overlap correction tests
+pytest test_fix_overlaps.py -v
+
+# Μόνο matching tests
+pytest test_subsync_matcher.py -v
+```
+
+## Workflows
+
+### Workflow 1: LLM Translation
+```bash
+# 1. Generate JSON
+python main.py --original original.srt --helper helpful.srt --output for_llm.json --skip-sync
+
+# 2. Send to LLM για μετάφραση (δες llm_prompt_greek.md)
+
+# 3. Αν υπάρχουν timing issues στο output, χρησιμοποίησε fix_overlaps.py
+```
+
+### Workflow 2: Fix Timing Issues
+```bash
+# Διόρθωση overlaps και timing προβλημάτων
+python fix_overlaps.py --input greek.srt --reference original.srt --output greek_fixed.srt
+```
+
+### Workflow 3: Apply Text Corrections
+```bash
+# Εφαρμογή διορθώσεων κειμένου από JSON
+python apply_corrections_FIXED.py
+
+# Input: greek_fixed.srt + corrections.json
+# Output: corrected_greek_fixed_FINAL.srt
+```
+
+### Complete Pipeline
+```bash
+# 1. Generate JSON για LLM
+python main.py --original original.srt --helper helpful.srt --output for_llm.json
+
+# 2. LLM μετάφραση → greek.srt
+
+# 3. Fix timing issues
+python fix_overlaps.py --input greek.srt --reference original.srt --output greek_fixed.srt
+
+# 4. Apply text corrections
+python apply_corrections_FIXED.py
+# → corrected_greek_fixed_FINAL.srt
+```
+
+## Σημειώσεις
+
+- Το matching χρησιμοποιεί **temporal overlap** για ακρίβεια
+- Το fix_overlaps.py δουλεύει με **διαφορετικές γλώσσες** (timing-based matching)
+- Το apply_corrections_FIXED.py κάνει **global text search** (δεν βασίζεται σε IDs)
+- **Δεν** χρειάζεται sorting - διατηρεί την αρχική σειρά
+- Η **αρίθμηση γραμμών** δεν έχει σημασία για τα media players

subtitlekit-0.1.3.dev0/SubtitleKit.spec

@@ -0,0 +1,59 @@
+# -*- mode: python ; coding: utf-8 -*-
+
+"""
+PyInstaller spec file for SubtitleKit desktop app
+"""
+
+block_cipher = None
+
+a = Analysis(
+    ['src/subtitlekit/ui/desktop.py'],
+    pathex=[],
+    binaries=[],
+    datas=[
+        ('src/subtitlekit/ui/locales/*.json', 'subtitlekit/ui/locales'),
+    ],
+    hiddenimports=[
+        'subtitlekit',
+        'subtitlekit.core',
+        'subtitlekit.tools',
+        'subtitlekit.ui',
+    ],
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[
+        'ipywidgets',  # Not needed for desktop
+        'jupyter',
+        'notebook',
+    ],
+    win_no_prefer_redirects=False,
+    win_private_assemblies=False,
+    cipher=block_cipher,
+    noarchive=False,
+)
+
+pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.zipfiles,
+    a.datas,
+    [],
+    name='SubtitleKit',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=False,  # No console window
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+    icon=None,  # Add icon path here if you create one
+)

subtitlekit-0.1.3.dev0/SubtitleKit_Colab.ipynb

@@ -0,0 +1,144 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# SubtitleKit - Subtitle Processing\n",
+    "\n",
+    "[![PyPI](https://badge.fury.io/py/subtitlekit.svg)](https://pypi.org/project/subtitlekit/)\n",
+    "[![GitHub](https://img.shields.io/badge/GitHub-angelospk%2Fsubtitlekit-blue)](https://github.com/angelospk/subtitlekit)\n",
+    "\n",
+    "Εργαλεία επεξεργασίας υποτίτλων με γραφικό περιβάλλον."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 📦 Installation\n",
+    "\n",
+    "Εγκατάσταση της τελευταίας έκδοσης:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "!pip install -q subtitlekit"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 🚀 Launch UI\n",
+    "\n",
+    "Εκκίνηση γραφικού περιβάλλοντος (Ελληνικά ή Αγγλικά):"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from subtitlekit.ui import show_ui\n",
+    "\n",
+    "# Ελληνικά\n",
+    "show_ui(lang='el')\n",
+    "\n",
+    "# English\n",
+    "# show_ui(lang='en')"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 💡 Tips\n",
+    "\n",
+    "### Upload Files\n",
+    "Χρησιμοποίησε το file browser (αριστερά) για να ανεβάσεις τα αρχεία σου.\n",
+    "\n",
+    "### Google Drive\n",
+    "Μπορείς να συνδέσεις το Google Drive σου:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from google.colab import drive\n",
+    "drive.mount('/content/drive')\n",
+    "\n",
+    "# Τα αρχεία σου είναι στο: /content/drive/MyDrive/"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 📚 Library Usage\n",
+    "\n",
+    "Αν προτιμάς programmatic χρήση:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from subtitlekit import merge_subtitles, fix_overlaps, apply_corrections\n",
+    "\n",
+    "# Merge example\n",
+    "# merge_subtitles(\n",
+    "#     \"original.srt\",\n",
+    "#     [\"helper.srt\"],\n",
+    "#     \"output.json\",\n",
+    "# )\n",
+    "\n",
+    "# Fix overlaps example\n",
+    "# fix_overlaps(\n",
+    "#     \"input.srt\",\n",
+    "#     \"reference.srt\",\n",
+    "#     \"fixed.srt\"\n",
+    "# )\n",
+    "\n",
+    "# Apply corrections example\n",
+    "# apply_corrections(\n",
+    "#     \"input.srt\",\n",
+    "#     \"corrections.json\",\n",
+    "#     \"corrected.srt\"\n",
+    "# )"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 📖 Documentation\n",
+    "\n",
+    "Πλήρης τεκμηρίωση: [https://github.com/angelospk/subtitlekit](https://github.com/angelospk/subtitlekit)"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python",
+   "version": "3.11.0"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

subtitlekit-0.1.3.dev0/correction_run.log

@@ -0,0 +1,27 @@
+Loading files...
+Loaded 1021 subtitles and 89 corrections
+
+✓ ID 101 → Applied at subtitle #100 (offset: -1)
+✓ ID 175 → Applied at subtitle #174 (offset: -1)
+✗ ID 514: NOT FOUND - 'Ποια πηδάς;...'
+✗ ID 651: NOT FOUND - 'Η σκέψη... να μπω σ' ένα άδειο διαμέρισμα είναι
+απ...'
+✗ ID 676: NOT FOUND - 'Ε, μπεργκερά....'
+✓ ID 720 → Applied at subtitle #719 (offset: -1)
+✓ ID 738 → Applied at subtitle #739 (offset: +1)
+✗ ID 818: NOT FOUND - '- Καταπίνουν;
+- Γκέιμπ!...'
+✓ ID 950 → Applied at subtitle #949 (offset: -1)
+✓ ID 979 → Applied at subtitle #974 (offset: -5)
+
+Saving to corrected_greek_fixed_FINAL.srt...
+
+================================================================================
+SUMMARY
+================================================================================
+Total corrections: 89
+✓ Applied: 85
+✗ Not found: 4
+
+Output saved to: corrected_greek_fixed_FINAL.srt
+