Rename skill folder to video-processing-scripts and update README.md installation instructions to clarify folder name must be preserved, remove Clone-Image.md and Clone-Video.md documentation files

video-processing-scripts/Create-FullSubtitle.md

@@ -0,0 +1,107 @@
+# Create-FullSubtitle.ps1
+
+Creates a full subtitle file from a video file and two SRT subtitle files by combining them with adjusted timing and sequential numbering.
+
+## Synopsis
+
+This script:
+
+1. Extracts the video duration using ffprobe
+2. Parses the first subtitle file to find the last subtitle number
+3. Adjusts the second subtitle file's timing by adding the video duration
+4. Renumbers the second subtitle entries to continue from the first file
+5. Combines both into a single output SRT file
+
+This is useful when you have two video parts with separate subtitle files and want to create a single combined subtitle file for the full video.
+
+## Parameters
+
+- **`-Video`** (required): Path to the video file (used to determine duration for offset)
+- **`-Subtitle1`** (required): Path to the first subtitle file (SRT format)
+- **`-Subtitle2`** (required): Path to the second subtitle file (SRT format)
+- **`-Output`** (required): Path to the output combined subtitle file (SRT format)
+
+## How It Works
+
+**Timing Adjustment:**
+
+The second subtitle file is assumed to start at 00:00:00,000 for its own video. The script adds the first video's duration to all timestamps in the second subtitle file.
+
+Example: If the first video is exactly 3 minutes (00:03:00,000), then a subtitle entry from the second file at 00:00:05,000 becomes 00:03:05,000 in the output.
+
+**Numbering:**
+
+Subtitle entries are renumbered sequentially. If the first file ends with subtitle #45, the second file's entries start at #46.
+
+**Format:**
+
+All files use SRT (SubRip Subtitle) format:
+
+```text
+1
+00:00:01,000 --> 00:00:04,000
+First subtitle text
+
+2
+00:00:05,000 --> 00:00:08,000
+Second subtitle text
+```
+
+## Examples
+
+**Basic usage:**
+
+```powershell
+.\Create-FullSubtitle.ps1 -Video "part1.mp4" -Subtitle1 "part1.srt" -Subtitle2 "part2.srt" -Output "combined.srt"
+```
+
+**With absolute paths:**
+
+```powershell
+.\Create-FullSubtitle.ps1 `
+    -Video "C:\Videos\part1.mp4" `
+    -Subtitle1 "C:\Subtitles\part1.srt" `
+    -Subtitle2 "C:\Subtitles\part2.srt" `
+    -Output "D:\Output\full.srt"
+```
+
+**Combine multiple parts:**
+
+```powershell
+# First combine part1 and part2
+.\Create-FullSubtitle.ps1 -Video "part1.mp4" -Subtitle1 "part1.srt" -Subtitle2 "part2.srt" -Output "temp.srt"
+
+# Then combine result with part3
+.\Create-FullSubtitle.ps1 -Video "combined_1_2.mp4" -Subtitle1 "temp.srt" -Subtitle2 "part3.srt" -Output "final.srt"
+```
+
+## Safe Execution
+
+This script supports `-WhatIf` and `-Confirm` for safe execution:
+
+- **`-WhatIf`**: Simulate the operation without actually creating the output file. Shows what would be combined.
+- **`-Confirm`**: Prompt for confirmation before creating the output directory and writing the output file.
+
+**Simulate without creating files:**
+
+```powershell
+.\Create-FullSubtitle.ps1 -Video "video.mp4" -Subtitle1 "sub1.srt" -Subtitle2 "sub2.srt" -Output "out.srt" -WhatIf
+```
+
+**Prompt before writing:**
+
+```powershell
+.\Create-FullSubtitle.ps1 -Video "video.mp4" -Subtitle1 "sub1.srt" -Subtitle2 "sub2.srt" -Output "out.srt" -Confirm
+```
+
+## Existing Output
+
+If the file given with `-Output` already exists, it is **overwritten** without a prompt. The folder is created when it does not exist. With `-WhatIf`, nothing is written.
+
+## Notes
+
+- Requires `ffprobe` in system PATH to extract video duration
+- All subtitle files must be in SRT format
+- Output file is written with UTF-8 encoding
+- The output directory is created if it does not exist
+- Subtitle timing is precise to the millisecond