guru/Video-Processing-Scripts
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
62 Commits 1 Branch 0 Tags
4378e3fd995da9985892fc708819986bbda8c5f8
T
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
guru 4378e3fd99 Rename -Scene parameter to -Level in Create-Scenes.ps1, add -Scenes parameter for automatic level search to detect exact scene count with binary search algorithm, update documentation across Create-Scenes.md, SKILL.md, README.md and index.md to explain search behavior and exit code 1 on failure, fix agent skills directory paths to use Windows environment variables and add VS Code location
2026-11-02 16:42:36 -05:00
video-processing-scripts
Rename -Scene parameter to -Level in Create-Scenes.ps1, add -Scenes parameter for automatic level search to detect exact scene count with binary search algorithm, update documentation across Create-Scenes.md, SKILL.md, README.md and index.md to explain search behavior and exit code 1 on failure, fix agent skills directory paths to use Windows environment variables and add VS Code location
2026-11-02 16:42:36 -05:00
Clone-Image.cmd
Add -LTX parameter to select closest LTX-2 canonical resolution for specified aspect ratio when using -Size with HD/1080p/720p/480p presets
2026-06-10 11:32:15 -04:00
Clone-Image.ps1
Add upscayl-bin command line logging to Clone-Image.ps1 for debugging upscaling operations
2026-06-10 17:58:20 -04:00
Clone-Video.cmd
Inital push
2026-05-19 14:55:09 -04:00
Clone-Video.ps1
Replace deprecated -vsync flag with -fps_mode in Clone-Video.ps1 and Get-FramesRange.ps1 frame extraction commands to use current ffmpeg syntax while maintaining vfr (variable frame rate) behavior
2026-11-02 07:00:26 -05:00
Compare-Videos.cmd
Inital push
2026-05-19 14:55:09 -04:00
Compare-Videos.ps1
Add exact-fit mode to Compare-Videos.ps1 for two sources that already tile the output frame perfectly (e.g. 1280x1080 + 640x1080 -> 1920x1080), stacking them side by side with no scaling or padding when both heights match output height and widths sum to output width, refactor dimension probing into Get-VideoDimensions function to eliminate duplicate ffprobe calls, and update documentation to explain exact-fit behavior and that -Clip and -Sideways have no effect in this mode
2026-10-14 10:41:21 -04:00
Create-Clip.cmd
Rename -Source parameter to -Video in Create-Clip.ps1 and Create-PillarBox.ps1 for consistency with other scripts, updating all internal variable names (sourcePath->videoPath, sourceFull->videoFull) and documentation references, while preserving .skip marker handling and parameter forwarding logic in Create-Clip.ps1 and maintaining default -Target derivation and effect naming in Create-PillarBox.ps1
2026-10-31 00:20:02 -04:00
Create-Clip.ps1
Fix -Frames negative range calculation to extract last N frames correctly (off-by-one error), add validation to reject invalid '-%' and '-0' formats with exit code 1, change '%' alone to extract single last frame instead of range, remove duplicate last frame from PNG sequence concat list, update Get-LastFrame.ps1 and Get-Frame.ps1 to clamp out-of-range frame indices instead of erroring and improve error messages with inline stderr output, add -y flag and -- separator to ffprobe calls, replace deprecated
2026-11-02 06:30:38 -05:00
Create-FullSubtitle.cmd
Inital push
2026-05-19 14:55:09 -04:00
Create-FullSubtitle.ps1
ix Get-Frame.ps1 parameter forwarding to use preference variable splatting instead of manual array building, preventing positional binding issues, update Get-FramesRange.ps1 to add -y flag for automatic overwrite of existing PNG files, fix Create-ShortClip.ps1 to skip clearing default Frames directory when -Render is used (frames are input not output) and add null checks before Test-Path in cleanup logic, and update documentation in Create-FullSubtitle.ps1 and Create-ShortClip.ps1 to clarify existing
2026-11-01 16:58:24 -05:00
Create-PillarBox.cmd
Add safe property accessor to Get-VideoInfo function for strict mode compatibility
2026-05-30 12:13:54 -04:00
Create-PillarBox.ps1
Rename -Source parameter to -Video in Create-Clip.ps1 and Create-PillarBox.ps1 for consistency with other scripts, updating all internal variable names (sourcePath->videoPath, sourceFull->videoFull) and documentation references, while preserving .skip marker handling and parameter forwarding logic in Create-Clip.ps1 and maintaining default -Target derivation and effect naming in Create-PillarBox.ps1
2026-10-31 00:20:02 -04:00
Create-Scenes.cmd
Change -Suffix parameter in Create-Clip.ps1 from optional empty string to required non-empty string with default value "-Clip", removing the hardcoded "-Clip" prefix from target name derivation so suffix is inserted directly before extension (e.g. default behavior unchanged: P01.mp4 -> P01-Clip.mp4, but custom -Suffix "-Shot-1" now makes P01.mp4 -> P01-Shot-1.mp4 instead of P01-Clip-Shot-1.mp4), add ValidateNotNullOrEmpty attribute, update documentation to reflect new default and behavior, and add installation
2026-11-01 11:02:32 -05:00
Create-Scenes.ps1
Rename -Scene parameter to -Level in Create-Scenes.ps1, add -Scenes parameter for automatic level search to detect exact scene count with binary search algorithm, update documentation across Create-Scenes.md, SKILL.md, README.md and index.md to explain search behavior and exit code 1 on failure, fix agent skills directory paths to use Windows environment variables and add VS Code location
2026-11-02 16:42:36 -05:00
Create-ShortClip.cmd
Inital push
2026-05-19 14:55:09 -04:00
Create-ShortClip.ini
Inital push
2026-05-19 14:55:09 -04:00
Create-ShortClip.ps1
ix Get-Frame.ps1 parameter forwarding to use preference variable splatting instead of manual array building, preventing positional binding issues, update Get-FramesRange.ps1 to add -y flag for automatic overwrite of existing PNG files, fix Create-ShortClip.ps1 to skip clearing default Frames directory when -Render is used (frames are input not output) and add null checks before Test-Path in cleanup logic, and update documentation in Create-FullSubtitle.ps1 and Create-ShortClip.ps1 to clarify existing
2026-11-01 16:58:24 -05:00
Create-Turnaround.cmd
Add Create-Turnaround.ps1 and Create-Turnaround.cmd wrapper scripts for combining image sequences into turnaround/character reference sheet images arranged in a row or grid, supporting PNG/JPEG/WEBP/BMP/AVIF/TIFF formats with natural numeric sorting, automatic cell sizing based on largest image with centered padding for smaller images using -Background color, configurable -Rows and -Columns layout with incomplete last row centering, format-specific -Quality and -Compression parameters matching Clone
2026-10-18 16:33:32 -04:00
Create-Turnaround.ps1
Add optional -Target parameter to Create-Turnaround.ps1 that defaults to '<last directory member>.jpg' in current directory, deriving name from source directory when -Source is a directory or from current directory when -Source is a file pattern, with drive root detection that throws an error for paths like 'C:\' that have no directory member to name the file after
2026-10-20 08:31:26 -04:00
Crop-Clips.cmd
Inital push
2026-05-19 14:55:09 -04:00
Crop-Clips.ps1
Add -Size parameter to Crop-Clips.ps1 for custom output resolution with cover-scaling and center-cropping, supporting named presets (320p-4K) that transpose for portrait sources and custom "width:height" format, overriding the cropProfiles table to process videos of any resolution instead of skipping non-standard sizes, with even-number dimension rounding for yuv420p compatibility and skipping of videos already at requested size, plus fix output info reporting to skip when -WhatIf or declined -Confirm leaves
2026-10-22 08:30:52 -04:00
Get-Frame.cmd
Remove Get-Frames.ps1 and Get-Frames.cmd scripts for frame extraction functionality
2026-08-27 20:14:48 -04:00
Get-Frame.ps1
Fix -Frames negative range calculation to extract last N frames correctly (off-by-one error), add validation to reject invalid '-%' and '-0' formats with exit code 1, change '%' alone to extract single last frame instead of range, remove duplicate last frame from PNG sequence concat list, update Get-LastFrame.ps1 and Get-Frame.ps1 to clamp out-of-range frame indices instead of erroring and improve error messages with inline stderr output, add -y flag and -- separator to ffprobe calls, replace deprecated
2026-11-02 06:30:38 -05:00
Get-FramesCount.cmd
Inital push
2026-05-19 14:55:09 -04:00
Get-FramesCount.ps1
Inital push
2026-05-19 14:55:09 -04:00
Get-FramesRange.cmd
Remove Get-Frames.ps1 and Get-Frames.cmd scripts for frame extraction functionality
2026-08-27 20:14:48 -04:00
Get-FramesRange.ps1
Replace deprecated -vsync flag with -fps_mode in Clone-Video.ps1 and Get-FramesRange.ps1 frame extraction commands to use current ffmpeg syntax while maintaining vfr (variable frame rate) behavior
2026-11-02 07:00:26 -05:00
Get-LastFrame.cmd
Inital push
2026-05-19 14:55:09 -04:00
Get-LastFrame.ps1
Fix -Frames negative range calculation to extract last N frames correctly (off-by-one error), add validation to reject invalid '-%' and '-0' formats with exit code 1, change '%' alone to extract single last frame instead of range, remove duplicate last frame from PNG sequence concat list, update Get-LastFrame.ps1 and Get-Frame.ps1 to clamp out-of-range frame indices instead of erroring and improve error messages with inline stderr output, add -y flag and -- separator to ffprobe calls, replace deprecated
2026-11-02 06:30:38 -05:00
Get-VideoAudio.cmd
Inital push
2026-05-19 14:55:09 -04:00
Get-VideoAudio.ps1
Inital push
2026-05-19 14:55:09 -04:00
Get-VideoInfo.cmd
Inital push
2026-05-19 14:55:09 -04:00
Get-VideoInfo.ini
Add Video_Length field to Get-VideoInfo.ini mapping to frames_count for reading actual encoded frame count directly from ffprobe instead of JSON metadata, with duration calculation using real fps
2026-07-03 10:17:50 -04:00
Get-VideoInfo.ps1
Add Video_Length field to Get-VideoInfo.ini mapping to frames_count for reading actual encoded frame count directly from ffprobe instead of JSON metadata, with duration calculation using real fps
2026-07-03 10:17:50 -04:00
README.md
Rename -Scene parameter to -Level in Create-Scenes.ps1, add -Scenes parameter for automatic level search to detect exact scene count with binary search algorithm, update documentation across Create-Scenes.md, SKILL.md, README.md and index.md to explain search behavior and exit code 1 on failure, fix agent skills directory paths to use Windows environment variables and add VS Code location
2026-11-02 16:42:36 -05:00
Stitch-InBetween.cmd
Rename Stich-InBetween.ps1 to Stitch-InBetween.ps1 and delete corresponding .cmd wrapper to correct spelling error in script name, updating README.md table entry to reflect corrected filename
2026-11-01 11:42:54 -05:00
Stitch-InBetween.ps1
Rename Stich-InBetween.ps1 to Stitch-InBetween.ps1 and delete corresponding .cmd wrapper to correct spelling error in script name, updating README.md table entry to reflect corrected filename
2026-11-01 11:42:54 -05:00
Update-Video-Processing-Scripts.cmd
Fix branch name from main to master and add pause at script end
2026-05-21 20:03:00 -04:00

README.md

Video Processing PowerShell Scripts

A collection of PowerShell scripts for video processing tasks using ffmpeg and ffprobe.

Prerequisites

  • PowerShell 7+ (pwsh.exe)
  • Platform: tested on Windows 11 only. Linux and WSL are not tested and not supported.
  • ffmpeg - Must be in system PATH. Not needed by Get-FramesCount.ps1, Get-VideoInfo.ps1 and Create-FullSubtitle.ps1.
  • ffprobe - Must be in system PATH. Not needed by Stitch-InBetween.ps1.
  • rife-ncnn-vulkan - Must be in system PATH and also defined the environment variable RIFE_HOME to the same directory
  • upscayl-bin - Must be in system PATH and also defined the environment variable UPSCAYL_HOME to the same directory

ffmpeg

To install ffmpeg on Windows, download it from ffmpeg.org and add it to your system PATH. The latest release is available from BtbN FFmpeg-Builds. The Windows build used here is the win64-gpl flavor.

rife-ncnn-vulkan

To install rife-ncnn-vulkan on Windows, see the RIFE 4.26 installation guide. Add it to your system PATH.

upscayl-bin

To install upscayl-bin on Windows, see the Upscalers installation guide. Add it to your system PATH.

NCNN_GPU_ID

The environment variable NCNN_GPU_ID is used to specify the GPU device ID for ncnn-based applications.

This environment variable must be set for both rife-ncnn-vulkan and upscayl-bin.

The value stored in NCNN_GPU_ID will be either:

  • 0 — use the first Vulkan-capable GPU (device index 0). If you have multiple GPUs, they'd be 0, 1, 2, etc.
  • -1 — use CPU only (no Vulkan GPU is available).

These map directly to the -g flag values accepted by both rife-ncnn-vulkan and upscayl-bin:

-g value Meaning
0 First GPU
1 Second GPU
2 Third GPU
-1 CPU

Scripts Overview

Script Purpose
Clone-Image.ps1 Clone/copy image files with optional resizing (cover-scale then crop), format conversion, and quality/compression settings
Clone-Video.ps1 Clone/copy video files with optional frame range and sequence extraction
Compare-Videos.ps1 Combine 2 to 4 video files into a single 1920x1080 side-by-side or grid comparison video
Create-Clip.ps1 Create a clip of a frame range from a video, named from the source with a suffix (default -Clip)
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
Create-PillarBox.ps1 Wrap a video in a 16:9 frame with selectable side-bar effects (black, white, blurred-background variants)
Create-Scenes.ps1 Detect scene changes with ffmpeg and extract each scene as a separate clip using Create-Clip.ps1
Create-ShortClip.ps1 Create short clips from videos with cropping and overlay options
Create-Turnaround.ps1 Combine a sequence of images into a single turnaround (character reference sheet) image, in a row or a grid
Crop-Clips.ps1 Batch crop videos generated by LTX-2, Kling and Wan from their non-standard resolutions to standard ones (also scales any square video to 1080x1080)
Get-Frame.ps1 Extract a specific frame of a video to PNG, with the image name derived from the video and frame index
Get-FramesCount.ps1 Get total frame count of a video
Get-FramesRange.ps1 Extract a range of frames to PNG images
Get-LastFrame.ps1 Extract a specific frame or last frame to PNG, with an optional filename pattern
Get-VideoAudio.ps1 Extracts audio in either WAV or MP3 format from a video file
Get-VideoInfo.ps1 Extract and display video metadata from comment tags
Stitch-InBetween.ps1 Generate interpolated in-between frames between two images using RIFE and encode to video

Important:

  • All scripts require PowerShell 7+ (use pwsh.exe)
  • Each script has its own Windows command file (.cmd) that calls the PowerShell script

Scripts Installation

The scripts are available from two locations:

  • SVN: public-svn, project: Video Processing Scripts.
  • Git: git.gurusushi.dyndns.org, repository: guru/Video-Processing-Scripts.
git clone https://git.gurusushi.dyndns.org/guru/Video-Processing-Scripts.git

Note: there is a Update-Video-Processing-Scripts.cmd script that can be used to update the directory from Git to get the latest version.

Add the project folder to your PATH environment variable to access the scripts from any location.

Agent Skill

SKILL.md is an agent skill for AI coding agents (such as Claude Code or Devin). It teaches the agent how to use these scripts safely, so the agent does not have to rediscover the documentation for each task.

What it covers:

  • Prerequisites and environment: PowerShell 7+, ffmpeg, ffprobe, rife-ncnn-vulkan and upscayl-bin, and the RIFE_HOME, UPSCAYL_HOME and NCNN_GPU_ID variables. The agent checks them once before first use, and stops to ask you if something is missing instead of installing it.
  • Safety rules: it always previews with -WhatIf first, never passes -Confirm, and lists which scripts overwrite or delete existing files.
  • Script catalog: every script with a one-line purpose and a link to its page. The agent loads a page only when it needs the details.
  • Workflows and troubleshooting: common recipes, such as clipping a frame range or detecting scenes, and the documented error messages with their fixes.

To use it, copy the whole video-processing-scripts folder directly into your agent's skills directory, keeping the folder name. Do not copy only SKILL.md: it links to the documentation pages by relative path, so those pages must stay in the same folder. For example:

  • Claude Code: "%USERPROFILE%\.claudeskills\video-processing-scripts\"
  • Devin: "%USERPROFILE%\.codeium\windsurf\skills\"
  • VS Code: "%USERPROFILE%\.copilot\skills\"

The video-processing-scripts folder is available in both repositories:

  • Git (guru/Video-Processing-Scripts): the video-processing-scripts folder.
  • SVN (project Video Processing Scripts): the video-processing-scripts folder.

Each copy contains SKILL.md and the markdown documentation pages required by the skill.

Notes

  • All scripts require PowerShell 7+ (use pwsh.exe)
  • File extensions (.mp4, .png) are automatically added if not provided
  • Paths can be absolute or relative to current directory
  • Use .skip.mp4 extension to exclude files from batch processing
  • Backup files (.bak.mp4) are automatically skipped in batch operations

Troubleshooting

Error: "Video file not found"

  • Check that the file path is correct
  • Ensure file exists at specified location
  • Use absolute paths if relative paths aren't working

Error: "ffmpeg failed" or "ffprobe failed"

  • Verify ffmpeg and ffprobe are installed and in PATH
  • Check that the video file is not corrupted
  • Ensure sufficient disk space for output

Error: "Frame index out of range"

  • Use Get-FramesCount.ps1 to check valid frame range
  • Frame indices are 0-based (first frame is 0)
Reference in new issue View Git Blame Copy Permalink
S
Description
No description provided
Readme
486 KiB
0 Stars 1 Watchers 0 Forks
Languages
PowerShell 98.7%
Batchfile 1.3%