Join-TsFile.ps1 - processing chunks

- fixed "The command line is too long" by processing files in chunks
- updated documentation

Author: alan-null

media/Join-TsFile.ps1

@@ -1,19 +1,22 @@
 function Join-TsFile {
     <#
 .SYNOPSIS
-Helper script for concatenating .ts files
+Concatenates .ts video files in a specified location into a single output file
 
 .DESCRIPTION
-This script will join *.ts files from a given directory or list of files passed as an argument
+This cmdlet concatenates .ts video files from a specified directory or a list of files into a single output file. The files are processed in chunks to avoid command line length limitations, making the script suitable for handling a large number of files. If a FilesLocation is provided, it sorts the .ts files by creation time. If Files are provided, it uses that list instead. The output file is named "out.ts" by default.
 
 .PARAMETER FilesLocation
-Location of the folder where your DLLs live.
+The path to the directory containing the .ts files to concatenate. If not specified, the cmdlet will use the files provided in the -Files parameter.
 
 .PARAMETER Files
-Location of the folder where your DLLs live.
+An array of System.IO.FileInfo objects representing the .ts files to concatenate. If specified, this parameter overrides FilesLocation.
 
 .PARAMETER OutFile
-Location of the folder where your DLLs live.
+The name of the output file. By default, this is set to "out.ts".
+
+.PARAMETER ChunkSize
+The number of files to process in each chunk. This helps to avoid exceeding the command line length limit when concatenating files.
 
 .EXAMPLE
 Join-TsFile "c:\test\"
@@ -22,14 +25,21 @@ Joins all *.ts files found in a "c:\test\" directory
 .EXAMPLE
 Join-TsFile -Files (gci "c:\test\2")
 Joins all files passed as with Files argument
+
+.NOTES
+The cmdlet changes the current location to the directory specified by FilesLocation and restores the original location after the operation is complete.
+If the total command length is too long for the cmd /c copy operation, reducing the ChunkSize may help avoid errors.
+
 #>
     param (
         [Parameter(Mandatory = $false, Position = 0)]
         [string]$FilesLocation,
         [Parameter(Mandatory = $false, Position = 1)]
         [System.IO.FileInfo[]]$Files,
         [Parameter(Mandatory = $false, Position = 2)]
-        [string]$OutFile = "out.ts"
+        [string]$OutFile = "out.ts",
+        [Parameter(Mandatory = $false, Position = 3)]
+        [int]$ChunkSize = 1000
     )
 
     $location = Get-Location
@@ -42,9 +52,14 @@ Joins all files passed as with Files argument
             $tsFile = $Files | Select-Object -First 1
             $FilesLocation = $tsFile.Directory
         }
-        $concatenatedNames = $fileNames -join "+"
         Set-Location $FilesLocation
-        cmd /c copy /b $concatenatedNames $OutFile | Out-Null
+
+        Copy-Item -Path $fileNames[0] -Destination $OutFile
+        for ($i = 1; $i -lt $fileNames.Count; $i += $ChunkSize) {
+            $chunk = $fileNames[$i..([math]::Min($i + $ChunkSize - 1, $fileNames.Count - 1))]
+            $concatenatedNames = $chunk -join "+"
+            cmd /c copy /b "$OutFile+$concatenatedNames" $OutFile | Out-Null
+        }
     }
     finally {
         Set-Location $location