appydave-tools 0.11.9 → 0.11.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f510d56c366a201d0769ce2687b3bc6d541ca86ca279444015196df022d907c3
-  data.tar.gz: 064a5daa6e27708d59bd4b6d71f6ec2fca41852e1738629b4a2767eb93e81b96
+  metadata.gz: 9e7b8ce2de26afecd3f37579dc6b1a414de7f28812ad4399a01f3d3adf2e23b8
+  data.tar.gz: 3156df843020c573448b8360f498b7c82510fba18a226339d07328f1cca6057c
 SHA512:
-  metadata.gz: 38220bd9663ce88119f724d053e24bb392148d9de398752e5e5748e73933e6021724066aff1fafc9bbe9f4eebece5ddb3b250e41c24a10bcba59de0fbec76be6
-  data.tar.gz: c9ac5c67c2fc177eb6ce02fe5e19a9b5c0caf67c041727d4226ee0d47a23e20931f9865c529dd468ff7f9e97729e1e3bfb7cd04deaeb3954c4d3e2c80891d240
+  metadata.gz: 15790b46559390d9a4e0816bc78c30d8204032daa156be756679762e27e48b4999b4ca5e35b23144dd986a6ce98ccd4bbc6ae1352a20c818527582e9b9a72475
+  data.tar.gz: 5afd2d9429afa607c4f79134a4dceee6f1afb0b852bc4125ecfa2b5cd2fb084402d1c64ad79d5e39237db829dab424446bfb1ea3fb4e4df993dc71725295a922

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [0.11.9](https://github.com/appydave/appydave-tools/compare/v0.11.8...v0.11.9) (2024-11-26)
+
+
+### Bug Fixes
+
+* SRT cleaner can work with string or file ([ddd3bdc](https://github.com/appydave/appydave-tools/commit/ddd3bdc7d70606bba91d81a7cdd5a9d3e8e7b409))
+
 ## [0.11.8](https://github.com/appydave/appydave-tools/compare/v0.11.7...v0.11.8) (2024-11-26)
 
 

data/lib/appydave/tools/subtitle_master/_doc-todo.md

@@ -0,0 +1,120 @@
+**Use Cases for Subtitle Management Tool (SRT-manage)**
+
+### Table of Contents
+1. [Join Multiple SRT Files](#1-join-multiple-srt-files)
+2. [Insert SRT at the Beginning of a Video](#2-insert-srt-at-the-beginning-of-a-video)
+3. [Insert SRT in the Middle of a Video](#3-insert-srt-in-the-middle-of-a-video)
+4. [Shift Timestamps](#4-shift-timestamps)
+5. [Find Timestamp by Text](#5-find-timestamp-by-text)
+6. [Find Timestamp by Approximate Time](#6-find-timestamp-by-approximate-time)
+7. [Extract Video Length](#7-extract-video-length)
+8. [Dry-Run (Optional)](#8-dry-run-optional)
+
+---
+
+### 1. Join Multiple SRT Files
+**Use case:** This action joins multiple subtitle files (SRT files), where each subsequent file is appended to the end of the previous one. The timestamps of each additional file are adjusted to start after the previous files finish.
+
+**Command:**
+```
+SRT-manage join -srt movie_part1.srt movie_part2.srt movie_part3.srt -output combined.srt -source-folder ./
+```
+**Arguments:**
+- **-srt** `<file1> <file2> ... <fileN>`: List of SRT files to join, provided in sequence.
+- **-output** `<file>`: Path for the output combined SRT file.
+- **-source-folder** `<folder>`: (Optional) Path to the folder containing SRT files. Defaults to `./` (current directory).
+
+### 2. Insert SRT at the Beginning of a Video
+**Use case:** Insert an SRT file at the very beginning of another video’s subtitle timeline. For example, if you want to add an intro/teaser subtitles before the main video.
+
+**Command:**
+```
+SRT-manage insert-beginning -srt main_video.srt -insert intro.srt -output final.srt
+```
+**Arguments:**
+- **-srt** `<file>`: Path to the main video SRT file.
+- **-insert** `<file>`: Path to the SRT file to be inserted at the beginning.
+- **-output** `<file>`: Path for the final output file.
+
+### 3. Insert SRT in the Middle of a Video
+**Use case:** Insert one SRT file at a specific point in another video’s timeline. For example, adding a call-to-action or an advertisement’s subtitles in the middle of a main video.
+
+**Command:**
+```
+SRT-manage insert-middle -srt main_video.srt -insert ad.srt -timecode 00:10:00 -output final.srt
+```
+**Arguments:**
+- **-srt** `<file>`: Path to the main video SRT file.
+- **-insert** `<file>`: Path to the SRT file to be inserted in the middle.
+- **-timecode** `<HH:MM:SS>`: The time in the video where the insertion should happen.
+- **-output** `<file>`: Path for the final output file.
+
+### 4. Shift Timestamps
+**Use case:** Adjust the timestamps of all subtitles in an SRT file by a certain offset, useful when a video has been edited or when subtitles need to be delayed or advanced.
+
+**Command:**
+```
+SRT-manage shift -srt main_video.srt -offset 30 -output shifted_video.srt
+```
+**Arguments:**
+- **-srt** `<file>`: Path to the SRT file.
+- **-offset** `<time_in_sec>`: Time in seconds to shift (positive or negative).
+- **-output** `<file>`: Path for the adjusted output file.
+
+### 5. Find Timestamp by Text
+**Use case:** Search the subtitle file for a specific phrase and return the closest matching timestamp. Useful when trying to locate where a certain line is spoken in the video.
+
+**Command:**
+```
+SRT-manage find-text -srt movie.srt -text "the quick brown fox"
+```
+**Arguments:**
+- **-srt** `<file>`: Path to the SRT file.
+- **-text** `"<phrase>"`: The phrase to search for in the subtitle text.
+
+### 6. Find Timestamp by Approximate Time
+**Use case:** Given a rough timecode, the system returns the closest matching subtitle timestamp. This helps find where subtitles start or stop near the provided time.
+
+**Command:**
+```
+SRT-manage find-time -srt movie.srt -timecode 00:10:00
+```
+**Arguments:**
+- **-srt** `<file>`: Path to the SRT file.
+- **-timecode** `<HH:MM:SS>`: The approximate time to search for.
+
+### 7. Extract Video Length
+**Use case:** Extract the total duration of a video file, which can then be used for timing calculations when adjusting or syncing SRT files.
+
+**Command:**
+```
+SRT-manage video-length -video movie.mov
+```
+**Arguments:**
+- **-video** `<file>`: Path to the video file.
+
+### 8. Dry-Run (Optional)
+**Use case:** Preview changes without actually writing the file. This can be used with any of the above actions to test changes before committing them.
+
+**Example (with shift action):**
+```
+SRT-manage shift -srt movie.srt -offset 15 -dry-run
+```
+**Argument:**
+- **-dry-run**: Show changes without applying them.
+
+---
+
+### **Summary of Example Use Cases:**
+1. **Join multiple SRT files:** Joining multiple parts of a movie's subtitles into one file.
+2. **Insert SRT at the beginning:** Adding intro subtitles before a movie starts.
+3. **Insert SRT in the middle:** Inserting an ad’s subtitles at a specific time in the video.
+4. **Shift timestamps:** Delaying subtitles by 30 seconds after a video has been edited.
+5. **Find timestamp by text:** Finding where the phrase “the quick brown fox” is spoken.
+6. **Find timestamp by timecode:** Locating the subtitle closest to 00:10:00.
+7. **Extract video length:** Getting the duration of a video for further calculations.
+
+---
+
+Does this structure work better for you? Each use case now has a clear description followed by a realistic command example and an explanation of the arguments. Let me know if any tweaks are needed!
+

data/lib/appydave/tools/version.rb

@@ -2,6 +2,6 @@
 
 module Appydave
   module Tools
-    VERSION = '0.11.9'
+    VERSION = '0.11.10'
   end
 end

data/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "appydave-tools",
-  "version": "0.11.9",
+  "version": "0.11.10",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appydave-tools",
-      "version": "0.11.9",
+      "version": "0.11.10",
       "devDependencies": {
         "@klueless-js/semantic-release-rubygem": "github:klueless-js/semantic-release-rubygem",
         "@semantic-release/changelog": "^6.0.3",

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appydave-tools",
-  "version": "0.11.9",
+  "version": "0.11.10",
   "description": "AppyDave YouTube Automation Tools",
   "scripts": {
     "release": "semantic-release"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: appydave-tools
 version: !ruby/object:Gem::Version
-  version: 0.11.9
+  version: 0.11.10
 platform: ruby
 authors:
 - David Cruwys
@@ -193,6 +193,7 @@ files:
 - lib/appydave/tools/name_manager/project_name.rb
 - lib/appydave/tools/prompt_tools/_doc.md
 - lib/appydave/tools/prompt_tools/prompt_completion.rb
+- lib/appydave/tools/subtitle_master/_doc-todo.md
 - lib/appydave/tools/subtitle_master/_doc.md
 - lib/appydave/tools/subtitle_master/clean.rb
 - lib/appydave/tools/types/array_type.rb