New-ImageConsoleStory

Examples

Author a paced multi-tab Windows Terminal presentation

PS>

$story = New-ImageConsoleStory -WindowStyle WindowsTerminal -Width 1100 -Speed Slow -Content {
               New-ImageConsoleStoryTab -Id PowerShell -Title 'PowerShell' -Profile PowerShell -Active
               New-ImageConsoleStoryCommand -Text 'dotnet build'
               New-ImageConsoleStoryOutput -Text 'Build succeeded.' -Style Success
            
               New-ImageConsoleStoryTab -Id WindowsPowerShell -Title 'Windows PowerShell' -Profile WindowsPowerShell
               New-ImageConsoleStoryCommand -Text '.\Invoke-LegacyTests.ps1'
               New-ImageConsoleStoryOutput -Text 'PS 5.1 compatibility passed.' -Style Success
            
               New-ImageConsoleStoryTab -Id Ubuntu -Title 'Ubuntu' -Profile Ubuntu
               New-ImageConsoleStoryCommand -Text './build.sh'
               New-ImageConsoleStoryOutput -Text 'Linux package ready.' -Style Success
             }
             $story | Export-ImageConsoleStory -Path '.\demo.gif'
        

Creates three persistent tab buffers. Each new tab opens atomically after the previous tab's reading dwell, then the shared story is exported through Export-ImageConsoleStory.

Jump between retained sessions intentionally

PS>

$story = New-ImageConsoleStory -WindowStyle WindowsTerminal -Speed Slow -Content {
               New-ImageConsoleStoryTab -Id PowerShell -Profile PowerShell -Active
               New-ImageConsoleStoryTab -Id Logs -Title 'Build logs' -Profile PowerShell -Background
               New-ImageConsoleStoryCommand -Text 'dotnet build'
               Select-ImageConsoleStoryTab -Id Logs
               New-ImageConsoleStoryOutput -Text 'Waiting for integration tests...' -Style Muted
               New-ImageConsoleStoryPause -Seconds 1.5
               Select-ImageConsoleStoryTab -Id PowerShell
               New-ImageConsoleStoryCommand -Text 'Get-ChildItem .\artifacts'
             }
             $story | Export-ImageConsoleStory -Path '.\navigation.gif'
        

Background prepares an inactive tab. Each Select step deliberately switches to a retained buffer; a pause can show that session ready and a later command continues it.

Render output captured from an actual script run

PS>

$output = & .\Invoke-EnvironmentAudit.ps1 2>&1 | Out-String -Stream -Width 110
             $story = $output | New-ImageConsoleStory -CommandText '.\Invoke-EnvironmentAudit.ps1' -Dialect PowerShell
             $story | Export-ImageConsoleStory -Path '.\audit-demo.svg'
        

The caller controls execution; the cmdlet only turns the captured lines into a deterministic presentation.

Export a portable animated GIF for chat or documentation

PS>

$story = New-ImageConsoleStory -Dialect CSharp -Title 'dotnet run - ChartForgeX' -Content {
               New-ImageConsoleStoryCommand -Text 'var chart = Chart.Create().WithTitle("Weekly builds");'
               New-ImageConsoleStoryCommand -Text 'chart.SavePng("weekly-builds.png");'
               New-ImageConsoleStoryOutput -Text 'Saved weekly-builds.png' -Style Success
             }
             $story | Export-ImageConsoleStory -Path '.\chart-demo.gif' -FramesPerSecond 10 -EndHoldSeconds 1.5
        

GIF and APNG export sample the same deterministic terminal timeline used by SVG and HTML.

Tune typing and tab reading time independently

PS>

$story = New-ImageConsoleStory -Speed Normal -TypingSpeed 36 -TabHoldSeconds 2.5 -Content {
               New-ImageConsoleStoryCommand -Text 'Invoke-ProjectBuild'
               New-ImageConsoleStoryOutput -Text 'Build completed.' -Style Success
             }
        

TypingSpeed is measured in visible characters per second. A command-level DurationSeconds value remains the most specific override.