subgapfix 0.0.1__tar.gz

subgapfix-0.0.1/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: subgapfix
+Version: 0.0.1
+Summary: A small CLI tool to extend subtitle durations in SRT files by redefining gaps between subtitles.
+Author-email: Reinder Sinnema <reinder@w3bunker.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: srt>=3.5.3
+
+# SubGapFix
+
+A small Python CLI tool to **extend subtitle durations** in `.srt` files so they stay on screen longer and feel more natural to read.  
+Designed especially for subtitles generated by [WhisperX](https://github.com/m-bain/whisperX), which often have very tight timings.
+
+## ✨ Features
+
+- Automatically extends subtitles when there’s a gap before the next subtitle.  
+- Prevents overlaps by adjusting start/end times safely.  
+- Configurable via CLI arguments.
+
+## 📦 Installation
+
+Clone the repository and install dependencies:
+
+```bash
+git clone https://github.com/yourusername/subgapfix.git
+cd subgapfix
+pip install -r requirements.txt
+````
+
+Dependencies:
+
+* [`srt`](https://pypi.org/project/srt/)
+
+## 🔧 Usage
+
+Basic usage:
+
+```bash
+python subgapfix.py input.srt -o easyreading.srt
+```
+
+### Options
+
+| Option                     | Default         | Description                                                               |
+|----------------------------|-----------------|---------------------------------------------------------------------------|
+| `-o, --output`             | `subgapfix.srt` | Output SRT file                                                           |
+| `--extend-sub-start, -ess` | `0.5`           | Seconds to add to start of subtitle. Default is `0.5`                     |
+| `--extend-sub-end, -ese`   | `2.0`           | Maximum seconds to add to end of subtitle. Default is `2.0`               |
+| `--min-gap, -mg`           | `1.0`           | Minimum gap (in seconds) required to apply extension. Default is `1.0`    |
+
+
+### How It Works
+
+The script reads your `.srt` file, loops through each pair of consecutive subtitles, and adjusts their timings to make them easier to read.  
+
+### Example
+
+Input:
+
+```
+1
+00:00:01,000 --> 00:00:03,000
+Hello there.
+
+2
+00:00:06,000 --> 00:00:08,000
+How are you?
+```
+
+Run:
+
+```bash
+python subgapfix.py input.srt -o fixed.srt
+```
+
+Output:
+
+```
+1
+00:00:01,000 --> 00:00:05,000
+Hello there.
+
+2
+00:00:05,500 --> 00:00:08,000
+How are you?
+```
+
+## 💡 Why?
+
+Tools like WhisperX produce accurate subtitles, but their timings are often too **tight** for comfortable reading.
+`SubGapFix` helps subtitles stay visible longer while keeping synchronization intact.
+
+## 🛠 Roadmap
+
+* Package for PyPI (`pip install subgapfix`)

subgapfix-0.0.1/README.md

@@ -0,0 +1,87 @@
+# SubGapFix
+
+A small Python CLI tool to **extend subtitle durations** in `.srt` files so they stay on screen longer and feel more natural to read.  
+Designed especially for subtitles generated by [WhisperX](https://github.com/m-bain/whisperX), which often have very tight timings.
+
+## ✨ Features
+
+- Automatically extends subtitles when there’s a gap before the next subtitle.  
+- Prevents overlaps by adjusting start/end times safely.  
+- Configurable via CLI arguments.
+
+## 📦 Installation
+
+Clone the repository and install dependencies:
+
+```bash
+git clone https://github.com/yourusername/subgapfix.git
+cd subgapfix
+pip install -r requirements.txt
+````
+
+Dependencies:
+
+* [`srt`](https://pypi.org/project/srt/)
+
+## 🔧 Usage
+
+Basic usage:
+
+```bash
+python subgapfix.py input.srt -o easyreading.srt
+```
+
+### Options
+
+| Option                     | Default         | Description                                                               |
+|----------------------------|-----------------|---------------------------------------------------------------------------|
+| `-o, --output`             | `subgapfix.srt` | Output SRT file                                                           |
+| `--extend-sub-start, -ess` | `0.5`           | Seconds to add to start of subtitle. Default is `0.5`                     |
+| `--extend-sub-end, -ese`   | `2.0`           | Maximum seconds to add to end of subtitle. Default is `2.0`               |
+| `--min-gap, -mg`           | `1.0`           | Minimum gap (in seconds) required to apply extension. Default is `1.0`    |
+
+
+### How It Works
+
+The script reads your `.srt` file, loops through each pair of consecutive subtitles, and adjusts their timings to make them easier to read.  
+
+### Example
+
+Input:
+
+```
+1
+00:00:01,000 --> 00:00:03,000
+Hello there.
+
+2
+00:00:06,000 --> 00:00:08,000
+How are you?
+```
+
+Run:
+
+```bash
+python subgapfix.py input.srt -o fixed.srt
+```
+
+Output:
+
+```
+1
+00:00:01,000 --> 00:00:05,000
+Hello there.
+
+2
+00:00:05,500 --> 00:00:08,000
+How are you?
+```
+
+## 💡 Why?
+
+Tools like WhisperX produce accurate subtitles, but their timings are often too **tight** for comfortable reading.
+`SubGapFix` helps subtitles stay visible longer while keeping synchronization intact.
+
+## 🛠 Roadmap
+
+* Package for PyPI (`pip install subgapfix`)

subgapfix-0.0.1/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=80.9.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "subgapfix"
+version = "0.0.1"
+description = "A small CLI tool to extend subtitle durations in SRT files by redefining gaps between subtitles."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+  { name = "Reinder Sinnema", email = "reinder@w3bunker.com" }
+]
+dependencies = [
+  "srt>=3.5.3"
+]
+
+[project.scripts]
+subgapfix = "subgapfix.subgapfix:main"

subgapfix-0.0.1/setup.cfg

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

subgapfix-0.0.1/src/subgapfix/subgapfix.py

@@ -0,0 +1,51 @@
+import argparse
+import srt
+from datetime import timedelta
+
+def extend_subs(input_file, output_file, extend_sub_start=0.5, extend_sub_end=2.0, min_gap=1.0):
+    
+    if min_gap > extend_sub_start:
+
+        with open(input_file, "r", encoding="utf-8") as f:
+            subs = list(srt.parse(f.read()))
+
+        for i in range(len(subs) - 1):
+            first, second = subs[i], subs[i + 1]
+            gap = (second.start - first.end).total_seconds()
+            
+            if gap < min_gap:
+                first.end += timedelta(seconds=gap/2)
+                second.start -= timedelta(seconds=gap/2)
+
+            if gap >= min_gap:
+                extendable = gap - extend_sub_start
+                if extendable > 0:
+                    extension = min(extendable, extend_sub_end)
+                    first.end += timedelta(seconds=extension)
+                    second.start -= timedelta(seconds=extend_sub_start)
+
+            # Make sure subs don't overlap each other
+            if second.start <= first.end:
+                second.start = first.end + timedelta(milliseconds=10)
+
+        with open(output_file, "w", encoding="utf-8") as f:
+            f.write(srt.compose(subs))
+
+    else:
+        print("Hold up! The value of min_gap should be greater than that of extended_sub_start.")
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Extend subtitle durations when there is a gap before the next subtitle."
+    )
+    parser.add_argument("input", help="Input SRT file")
+    parser.add_argument("-o", "--output", default="subgapfix.srt", help="Output SRT file")
+    parser.add_argument("--extend-sub-start", "-ess", type=float, default=0.5, help="Seconds to add to start of subtitle. Default is: -ess 0.5")
+    parser.add_argument("--extend-sub-end", "-ese", type=float, default=2.0, help="Seconds to add to end of subtitle. Default is: -ese 2.0")
+    parser.add_argument("--min-gap", "-mg", type=float, default=1.0, help="Minimum gap (in seconds) required to apply extension. Default is: -mg 1.0")
+    args = parser.parse_args()
+
+    extend_subs(args.input, args.output, args.extend_sub_start, args.extend_sub_end, args.min_gap)
+
+if __name__ == "__main__":
+    main()

subgapfix-0.0.1/src/subgapfix.egg-info/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: subgapfix
+Version: 0.0.1
+Summary: A small CLI tool to extend subtitle durations in SRT files by redefining gaps between subtitles.
+Author-email: Reinder Sinnema <reinder@w3bunker.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: srt>=3.5.3
+
+# SubGapFix
+
+A small Python CLI tool to **extend subtitle durations** in `.srt` files so they stay on screen longer and feel more natural to read.  
+Designed especially for subtitles generated by [WhisperX](https://github.com/m-bain/whisperX), which often have very tight timings.
+
+## ✨ Features
+
+- Automatically extends subtitles when there’s a gap before the next subtitle.  
+- Prevents overlaps by adjusting start/end times safely.  
+- Configurable via CLI arguments.
+
+## 📦 Installation
+
+Clone the repository and install dependencies:
+
+```bash
+git clone https://github.com/yourusername/subgapfix.git
+cd subgapfix
+pip install -r requirements.txt
+````
+
+Dependencies:
+
+* [`srt`](https://pypi.org/project/srt/)
+
+## 🔧 Usage
+
+Basic usage:
+
+```bash
+python subgapfix.py input.srt -o easyreading.srt
+```
+
+### Options
+
+| Option                     | Default         | Description                                                               |
+|----------------------------|-----------------|---------------------------------------------------------------------------|
+| `-o, --output`             | `subgapfix.srt` | Output SRT file                                                           |
+| `--extend-sub-start, -ess` | `0.5`           | Seconds to add to start of subtitle. Default is `0.5`                     |
+| `--extend-sub-end, -ese`   | `2.0`           | Maximum seconds to add to end of subtitle. Default is `2.0`               |
+| `--min-gap, -mg`           | `1.0`           | Minimum gap (in seconds) required to apply extension. Default is `1.0`    |
+
+
+### How It Works
+
+The script reads your `.srt` file, loops through each pair of consecutive subtitles, and adjusts their timings to make them easier to read.  
+
+### Example
+
+Input:
+
+```
+1
+00:00:01,000 --> 00:00:03,000
+Hello there.
+
+2
+00:00:06,000 --> 00:00:08,000
+How are you?
+```
+
+Run:
+
+```bash
+python subgapfix.py input.srt -o fixed.srt
+```
+
+Output:
+
+```
+1
+00:00:01,000 --> 00:00:05,000
+Hello there.
+
+2
+00:00:05,500 --> 00:00:08,000
+How are you?
+```
+
+## 💡 Why?
+
+Tools like WhisperX produce accurate subtitles, but their timings are often too **tight** for comfortable reading.
+`SubGapFix` helps subtitles stay visible longer while keeping synchronization intact.
+
+## 🛠 Roadmap
+
+* Package for PyPI (`pip install subgapfix`)

subgapfix-0.0.1/src/subgapfix.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/subgapfix/__init__.py
+src/subgapfix/subgapfix.py
+src/subgapfix.egg-info/PKG-INFO
+src/subgapfix.egg-info/SOURCES.txt
+src/subgapfix.egg-info/dependency_links.txt
+src/subgapfix.egg-info/entry_points.txt
+src/subgapfix.egg-info/requires.txt
+src/subgapfix.egg-info/top_level.txt

subgapfix-0.0.1/src/subgapfix.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

subgapfix-0.0.1/src/subgapfix.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+subgapfix = subgapfix.subgapfix:main

subgapfix-0.0.1/src/subgapfix.egg-info/requires.txt

@@ -0,0 +1 @@
+srt>=3.5.3

subgapfix-0.0.1/src/subgapfix.egg-info/top_level.txt

@@ -0,0 +1 @@
+subgapfix