en-US/about_ColorScripts-Enhanced.help.txt
|
TOPIC
about_ColorScripts-Enhanced SHORT DESCRIPTION Discover and display ANSI colorscripts in PowerShell. LONG DESCRIPTION ColorScripts-Enhanced is a cross-platform PowerShell module containing 3156 colorscripts. It supports Windows PowerShell 5.1 and PowerShell 7.x on Windows, macOS, and Linux. Most colorscripts are static and execute directly. Output caching is limited to the 15 expensive renderers selected by CachePolicy.psd1. Intentionally live renderers remain uncached when reuse would change their behavior. BASIC USAGE Import-Module ColorScripts-Enhanced Show-ColorScript Show-ColorScript -Name bars Get-ColorScriptList -Category Patterns Pokemon-themed scripts are excluded from random selection by default. Use -IncludePokemon to opt in. A directly requested Pokemon script still works. COMMANDS Show-ColorScript Displays a random or named colorscript. Alias: scs. Get-ColorScriptList Queries scripts by name, category, or tag. New-ColorScriptCache Builds caches for policy-selected renderers only. Clear-ColorScriptCache Removes named cache entries or all module cache data. Add-ColorScriptProfile Adds an idempotent module startup block to a PowerShell profile. Get-ColorScriptConfiguration, Set-ColorScriptConfiguration, Reset-ColorScriptConfiguration Read, persist, or reset module configuration. Export-ColorScriptMetadata Exports catalog, file, and optional cache metadata. New-ColorScript Creates a UTF-8 colorscript scaffold and metadata guidance. CACHE AND CONFIGURATION New-ColorScriptCache -All New-ColorScriptCache -Name Galaxy Clear-ColorScriptCache -All Get-ColorScriptConfiguration Query Get-ColorScriptConfiguration for the effective cache path. Set COLOR_SCRIPTS_ENHANCED_CONFIG_ROOT before importing the module to relocate persistent configuration. HELP AND VERSION Every exported command accepts -h (alias -help) for concise help. Use: Get-Help Show-ColorScript -Full Get-Help Show-ColorScript -Examples Get-Module ColorScripts-Enhanced | Select-Object Version The module manifest is the authoritative version source. ENCODING AND PROVENANCE Generated PowerShell scripts use UTF-8. Traditional source .ANS files often use CP437 and must be decoded accordingly. Third-party art retains its original authorship and source terms. SEE ALSO Show-ColorScript Get-ColorScriptList New-ColorScriptCache https://github.com/Nick2bad4u/ps-color-scripts-enhanced |