ColorScripts-Enhanced

2025.11.5.2155

nl/about_ColorScripts-Enhanced.help.txt

# ColorScripts-Enhanced Module Help
 
## about_ColorScripts-Enhanced
 
### SHORT DESCRIPTION
Verbeterde PowerShell ColorScripts met een hoogwaardig cachingsysteem voor het weergeven van mooie ANSI-kunst in uw terminal.
 
### LONG DESCRIPTION
ColorScripts-Enhanced is een PowerShell-module die een verzameling van 450++ mooie ANSI-kleurenscripts biedt voor terminalweergave. Het beschikt over een intelligent cachingsysteem dat 6-19x prestatieverbeteringen biedt ten opzichte van traditionele scriptuitvoering.
 
De module cachet automatisch scriptuitvoer naar een gecentraliseerde locatie in uw AppData-map, waardoor directe weergave mogelijk is bij volgende uitvoeringen. Cachebestanden worden automatisch gevalideerd en opnieuw gegenereerd wanneer bronscripts worden gewijzigd.
 
### FEATURES
- 450++ mooie kant-en-klare kleurenscripts
- Hoogwaardig cachingsysteem (6-19x sneller)
- Gecentraliseerde cachelocatie (werkt vanuit elke directory)
- Automatische cache-invalidatie bij scriptwijzigingen
- UTF-8 codering ondersteuning voor perfecte weergave
- Willekeurige kleurenscript selectie
- Gemakkelijke scriptontdekking en lijstweergave
- Profielhelper voor één-regelige opstartintegratie
- Aanhoudende configuratiehelpers voor cache en opstartgedrag
- Metadata-export en scaffolding workflows voor aangepaste scripts
 
### INSTALLATION
 
#### From PowerShell Gallery (Recommended)
```powershell
Install-Module -Name ColorScripts-Enhanced -Scope CurrentUser
```
 
Voeg de module automatisch toe aan uw profiel:
 
```powershell
Add-ColorScriptProfile # Import + Show-ColorScript
Add-ColorScriptProfile -SkipStartupScript
```
 
#### Manual Installation
1. Download de module van GitHub
2. Pak uit naar een PowerShell-modulepad:
   - Gebruiker: `$HOME\Documents\PowerShell\Modules\ColorScripts-Enhanced`
   - Systeem: `C:\Program Files\PowerShell\Modules\ColorScripts-Enhanced`
3. Importeer de module:
   ```powershell
   Import-Module ColorScripts-Enhanced
   ```
 
### QUICK START
 
Toon een willekeurig kleurenscript:
```powershell
Show-ColorScript
# of gebruik de alias
scs
```
 
Toon een specifiek kleurenscript:
```powershell
Show-ColorScript -Name hearts
scs mandelbrot-zoom
```
 
Lijst alle beschikbare kleurenscripts op:
```powershell
Show-ColorScript -List
Get-ColorScriptList
```
 
Bouw cache vooraf voor alle scripts:
```powershell
New-ColorScriptCache
```
 
### COMMANDS
 
De module exporteert de volgende commando's:
 
- `Show-ColorScript` - Toon kleurenscripts (alias: scs)
- `Get-ColorScriptList` - Toon beschikbare kleurenscripts
- `New-ColorScriptCache` - Vooraf cachebestanden genereren
- `Clear-ColorScriptCache` - Cachebestanden verwijderen
- `Add-ColorScriptProfile` - Module opstartfragment toevoegen aan een PowerShell-profiel
- `Get-ColorScriptConfiguration` - Cache en opstartstandaarden inspecteren
- `Set-ColorScriptConfiguration` - Aangepaste configuratiewaarden behouden
- `Reset-ColorScriptConfiguration` - Configuratie naar standaardwaarden herstellen
- `Export-ColorScriptMetadata` - Scriptmetadata exporteren voor automatisering
- `New-ColorScript` - Een nieuw kleurenscript en metadatfragment opzetten
 
Gebruik `Get-Help <CommandName> -Full` voor gedetailleerde hulp bij elk commando.
 
### CACHE SYSTEM
 
Het cachesysteem werkt automatisch:
 
1. **First Run**: Script wordt normaal uitgevoerd en uitvoer wordt gecached
2. **Subsequent Runs**: Gecachte uitvoer wordt direct weergegeven (6-19x sneller)
3. **Auto-Refresh**: Cache wordt opnieuw gegenereerd wanneer script wordt gewijzigd
 
**Cache Location**: `$env:APPDATA\ColorScripts-Enhanced\cache`
 
**Cache Benefits**:
- Directe weergave van complexe kleurenscripts
- Verminderde CPU-gebruik
- Consistente prestaties
- Werkt vanuit elke directory
 
### CONFIGURATION
 
#### Add to PowerShell Profile
Toon een willekeurig kleurenscript bij elke terminalstart:
 
```powershell
Add-ColorScriptProfile # Import + Show-ColorScript
Add-ColorScriptProfile -SkipStartupScript
```
 
#### Customize Cache Location
De cachelocatie wordt automatisch ingesteld op basis van uw platform:
 
Windows:
```powershell
$env:APPDATA\ColorScripts-Enhanced\cache
```
 
macOS:
```powershell
~/Library/Application Support/ColorScripts-Enhanced/cache
```
 
Linux:
```powershell
~/.cache/ColorScripts-Enhanced
```
 
### NERD FONT GLYPHS
 
Sommige scripts tonen Nerd Font iconen (ontwikkelaarsglyphs, powerline scheidingstekens, vinkjes). Installeer een gepatchte font zodat deze karakters correct worden weergegeven:
 
1. Download een font van https://www.nerdfonts.com/ (populaire keuzes: Cascadia Code, JetBrainsMono, FiraCode).
2. Windows: pak de `.zip` uit, selecteer de `.ttf` bestanden, rechtsklik → **Installeren voor alle gebruikers**.
   macOS: `brew install --cask font-caskaydia-cove-nerd-font` of voeg toe via Font Book.
   Linux: kopieer `.ttf` bestanden naar `~/.local/share/fonts` (of `/usr/local/share/fonts`) en voer `fc-cache -fv` uit.
3. Stel uw terminalprofiel in om de geïnstalleerde Nerd Font te gebruiken.
4. Verificeer glyphs met:
 
```powershell
Show-ColorScript -Name nerd-font-test
```
 
### EXAMPLES
 
#### Example 1: Random Colorscript on Startup
```powershell
# In your $PROFILE file:
Import-Module ColorScripts-Enhanced
Show-ColorScript
```
 
#### Example 2: Daily Different Colorscript
```powershell
# Use the date as seed for consistent daily script
$seed = (Get-Date).DayOfYear
Get-Random -SetSeed $seed
Show-ColorScript
```
 
#### Example 3: Build Cache for Favorite Scripts
```powershell
New-ColorScriptCache -Name hearts,mandelbrot-zoom,galaxy-spiral
```
 
#### Example 4: Force Cache Rebuild
```powershell
New-ColorScriptCache -Force
```
 
### TROUBLESHOOTING
 
#### Scripts not displaying correctly
Zorg ervoor dat uw terminal UTF-8 en ANSI escape codes ondersteunt:
```powershell
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
```
 
#### Cache not working
Cache wissen en opnieuw opbouwen:
```powershell
Clear-ColorScriptCache -All
New-ColorScriptCache
```
 
#### Performance issues
De eerste uitvoering van elk script zal langzamer zijn omdat het cache opbouwt. Bouw alle caches vooraf op:
```powershell
New-ColorScriptCache
```
 
### PERFORMANCE
 
Typische prestatieverbeteringen met caching:
 
| Script Type | Without Cache | With Cache | Speedup |
|------------|---------------|------------|---------|
| Simple | ~50ms | ~8ms | 6x |
| Medium | ~150ms | ~12ms | 12x |
| Complex | ~300ms | ~16ms | 19x |
 
### SCRIPT CATEGORIES
 
The module includes scripts in various categories:
 
- **Geometric**: mandelbrot-zoom, apollonian-circles, sierpinski-carpet
- **Nature**: galaxy-spiral, aurora-bands, crystal-drift
- **Artistic**: kaleidoscope, rainbow-waves, prismatic-rain
- **Gaming**: doom, pacman, space-invaders
- **System**: colortest, nerd-font-test, terminal-benchmark
- **Logos**: arch, debian, ubuntu, windows
 
### SEE ALSO
 
- GitHub Repository: https://github.com/Nick2bad4u/ps-color-scripts-enhanced
- Original inspiration: shell-color-scripts
- PowerShell Documentation: https://docs.microsoft.com/powershell/
 
### KEYWORDS
- ANSI
- Terminal
- Art
- ASCII
- Color
- Scripts
- Cache
- Performance
 
### ADVANCED USAGE
 
#### Building Cache for Specific Categories
Cache all scripts in the Geometric category for optimal performance:
```powershell
Get-ColorScriptList -Category Geometric -AsObject |
    ForEach-Object { New-ColorScriptCache -Name $_.Name }
```
 
#### Performance Measurement
Measure the performance improvement from caching:
```powershell
# Uncached performance (cold start)
Remove-Module ColorScripts-Enhanced -ErrorAction SilentlyContinue
$uncached = Measure-Command {
    Import-Module ColorScripts-Enhanced
    Show-ColorScript -Name "mandelbrot-zoom" -NoCache
}
 
# Cached performance (warm start)
$cached = Measure-Command {
    Show-ColorScript -Name "mandelbrot-zoom"
}
 
Write-Host "Uncached: $($uncached.TotalMilliseconds)ms"
Write-Host "Cached: $($cached.TotalMilliseconds)ms"
Write-Host "Speedup: $([math]::Round($uncached.TotalMilliseconds / $cached.TotalMilliseconds, 1))x"
```
 
#### Automation: Display Different Script Daily
Set up your profile to show a different script each day:
```powershell
# In your $PROFILE file:
$seed = (Get-Date).DayOfYear
[System.Random]::new($seed).Next()
Get-Random -SetSeed $seed
Show-ColorScript
```
 
#### Pipeline Operations with Metadata
Export colorscript metadata for use in other tools:
```powershell
# Export to JSON for web dashboard
Export-ColorScriptMetadata -Path ./dist/colorscripts.json -IncludeFileInfo
 
# Count scripts by category
Get-ColorScriptList -AsObject |
    Group-Object Category |
    Select-Object Name, Count |
    Sort-Object Count -Descending
 
# Find scripts with specific keywords
$scripts = Get-ColorScriptList -AsObject
$scripts |
    Where-Object { $_.Description -match 'fractal|mandelbrot' } |
    Select-Object Name, Category, Description
```
 
#### Cache Management for CI/CD Environments
Configure and manage cache for automated deployments:
```powershell
# Set temporary cache location for CI/CD
Set-ColorScriptConfiguration -CachePath $env:TEMP\colorscripts-cache
 
# Pre-build cache for deployment
$productionScripts = @('bars', 'arch', 'ubuntu', 'windows', 'rainbow-waves')
New-ColorScriptCache -Name $productionScripts -Force
 
# Verify cache health
$cacheDir = (Get-ColorScriptConfiguration).Cache.Path
Get-ChildItem $cacheDir -Filter "*.cache" | Measure-Object -Sum Length
```
 
#### Filtering and Display Workflows
Advanced filtering for customized displays:
```powershell
# Display all recommended scripts with details
Get-ColorScriptList -Tag Recommended -Detailed
 
# Show geometric scripts with caching disabled for testing
Get-ColorScriptList -Category Geometric -Name "aurora-*" -AsObject |
    ForEach-Object { Show-ColorScript -Name $_.Name -NoCache }
 
# Export metadata filtered by category
Export-ColorScriptMetadata -IncludeFileInfo |
    Where-Object { $_.Category -eq 'Animated' } |
    ConvertTo-Json |
    Out-File "./animated-scripts.json"
```
 
### ENVIRONMENT VARIABLES
 
De module respecteert de volgende omgevingsvariabelen:
 
- **COLORSCRIPTS_CACHE**: Overschrijf de standaard cachelocatie
- **PSModulePath**: Beïnvloedt waar de module wordt ontdekt
 
### PERFORMANCE TUNING
 
#### Typische Prestatiecijfers
| Scriptcomplexiteit | Zonder Cache | Met Cache | Verbetering |
|-------------------|--------------|-----------|-------------|
| Eenvoudig (50-100ms) | ~50ms | ~8ms | 6x sneller |
| Gemiddeld (100-200ms) | ~150ms | ~12ms | 12x sneller |
| Complex (200-300ms) | ~300ms | ~16ms | 19x sneller |
 
#### Cache Grootte Informatie
- Gemiddelde cache bestandsgrootte: 2-50KB per script
- Totale cachegrootte voor alle scripts: ~2-5MB
- Cachelocatie: Gebruikt OS-geschikte paden voor minimale voetafdruk
 
### TROUBLESHOOTING ADVANCED ISSUES
 
#### Module Niet Gevonden Fout
```powershell
# Controleer of module in PSModulePath staat
Get-Module ColorScripts-Enhanced -ListAvailable
 
# Toon beschikbare modulepaden
$env:PSModulePath -split ';'
 
# Importeer indien nodig vanaf expliciet pad
Import-Module "C:\Path\To\ColorScripts-Enhanced\ColorScripts-Enhanced.psd1"
```
 
#### Cache Corruptie
Wis volledig en bouw opnieuw op:
```powershell
# Verwijder module uit sessie
Remove-Module ColorScripts-Enhanced -Force
 
# Wis alle cachebestanden
Clear-ColorScriptCache -All -Confirm:$false
 
# Herimporteer en bouw cache opnieuw
Import-Module ColorScripts-Enhanced
New-ColorScriptCache -Force
```
 
#### Prestatieverslechtering
Als prestaties in de loop der tijd verslechteren:
```powershell
# Controleer cache directory grootte
$cacheDir = (Get-ColorScriptConfiguration).Cache.Path
$size = (Get-ChildItem $cacheDir -Filter "*.cache" |
    Measure-Object -Sum Length).Sum
Write-Host "Cache grootte: $([math]::Round($size / 1MB, 2)) MB"
 
# Wis oude cache en bouw opnieuw
Clear-ColorScriptCache -All
New-ColorScriptCache
```
 
### PLATFORM-SPECIFIC NOTES
 
#### Windows PowerShell 5.1
- Beperkt tot Windows alleen
- Gebruik `powershell.exe` om scripts uit te voeren
- Sommige geavanceerde functies zijn mogelijk niet beschikbaar
- Aanbevolen om te upgraden naar PowerShell 7+
 
#### PowerShell 7+ (Cross-Platform)
- Volledige ondersteuning op Windows, macOS en Linux
- Gebruik `pwsh` commando
- Alle functies volledig functioneel
- Aanbevolen voor nieuwe implementaties
 
### DETAILED COMMAND REFERENCE
 
#### Kerncommando's Overzicht
De module biedt 10 hoofdcommando's voor het beheren en weergeven van kleurenscripts:
 
**Weergavecommando's:**
- `Show-ColorScript` - Toon kleurenscripts met meerdere modi (willekeurig, benoemd, lijst, allemaal)
- `Get-ColorScriptList` - Toon beschikbare kleurenscripts met gedetailleerde metadata
 
**Cachebeheer:**
- `New-ColorScriptCache` - Bouw cachebestanden voor prestaties
- `Clear-ColorScriptCache` - Verwijder cachebestanden met filteropties
- `Build-ColorScriptCache` - Alias voor New-ColorScriptCache
 
**Configuratie:**
- `Get-ColorScriptConfiguration` - Haal huidige configuratie-instellingen op
- `Set-ColorScriptConfiguration` - Bewaar configuratiewijzigingen
- `Reset-ColorScriptConfiguration` - Herstel fabrieksinstellingen
 
**Profielintegratie:**
- `Add-ColorScriptProfile` - Integreer module in PowerShell-profiel
 
**Ontwikkeling:**
- `New-ColorScript` - Stel nieuw kleurenscript sjabloon op
- `Export-ColorScriptMetadata` - Exporteer metadata voor automatisering
 
#### Commando Gebruikspatronen
 
**Patroon 1: Snelle Weergave**
```powershell
Show-ColorScript # Willekeurig kleurenscript
scs # Module alias gebruiken
Show-ColorScript -Name aurora # Specifiek script
```
 
**Patroon 2: Ontdekking en Lijstweergave**
```powershell
Get-ColorScriptList # Alle scripts
Get-ColorScriptList -Detailed # Met tags en beschrijvingen
Get-ColorScriptList -Category Nature # Filter op categorie
Get-ColorScriptList -Tag Animated # Filter op tag
```
 
**Patroon 3: Prestatieoptimalisatie**
```powershell
New-ColorScriptCache # Bouw alle caches
New-ColorScriptCache -Name bars # Bouw specifieke cache
New-ColorScriptCache -Category Geometric # Bouw categorie
```
 
**Patroon 4: Cacheonderhoud**
```powershell
Clear-ColorScriptCache -All # Verwijder alle caches
Clear-ColorScriptCache -Name "test-*" # Wis patroon
Clear-ColorScriptCache -Category Demo # Wis op categorie
```
 
### DETAILED WORKFLOW EXAMPLES
 
#### Workflow 1: Initiële Installatie en Configuratie
```powershell
# Stap 1: Installeer de module
Install-Module -Name ColorScripts-Enhanced -Scope CurrentUser
 
# Stap 2: Voeg toe aan profiel voor automatische opstart
Add-ColorScriptProfile
 
# Stap 3: Bouw cache vooraf voor optimale prestaties
New-ColorScriptCache
 
# Stap 4: Verificeer installatie
Get-ColorScriptConfiguration
```
 
#### Workflow 2: Dagelijks Gebruik met Rotatie
```powershell
# In $PROFILE bestand toevoegen:
Import-Module ColorScripts-Enhanced
 
# Toon verschillend script elke dag gebaseerd op datum
$seed = (Get-Date).DayOfYear
Get-Random -SetSeed $seed
Show-ColorScript -Random
 
# Alternatief: Toon specifieke categorie
Show-ColorScript -Category Geometric -Random
```
 
#### Workflow 3: Automatisering Integratie
```powershell
# Exporteer metadata voor externe tools
$metadata = Export-ColorScriptMetadata -IncludeFileInfo -IncludeCacheInfo
$metadata | ConvertTo-Json | Out-File "./colorscripts.json"
 
# Gebruik in automatisering: cycli door scripts
$scripts = Get-ColorScriptList -Tag Recommended -AsObject
$scripts | ForEach-Object { Show-ColorScript -Name $_.Name; Start-Sleep -Seconds 2 }
```
 
#### Workflow 4: Prestatiebewaking
```powershell
# Meet cache effectiviteit
$uncached = Measure-Command { Show-ColorScript -Name mandelbrot-zoom -NoCache }
$cached = Measure-Command { Show-ColorScript -Name mandelbrot-zoom }
 
Write-Host "Ongecached: $($uncached.TotalMilliseconds)ms"
Write-Host "Gecached: $($cached.TotalMilliseconds)ms"
Write-Host "Verbetering: $([math]::Round($uncached.TotalMilliseconds / $cached.TotalMilliseconds, 1))x"
```
 
#### Workflow 5: Aanpassing en Ontwikkeling
```powershell
# Maak aangepast kleurenscript
New-ColorScript -Name "my-custom-art" -Category "Custom" -Tag "MyTag" -GenerateMetadataSnippet
 
# Bewerk het script
code "$env:USERPROFILE\Documents\PowerShell\Modules\ColorScripts-Enhanced\Scripts\my-custom-art.ps1"
 
# Voeg metadata toe (gebruik richtlijnen van generatie)
# Bewerk ScriptMetadata.psd1
 
# Cache en test
New-ColorScriptCache -Name "my-custom-art" -Force
Show-ColorScript -Name "my-custom-art"
```
 
### INTEGRATION SCENARIOS
 
#### Scenario 1: Terminal Welcome Screen
```powershell
# In profile:
$hour = (Get-Date).Hour
if ($hour -ge 6 -and $hour -lt 12) {
    Show-ColorScript -Tag "bright,morning" -Random
} elseif ($hour -ge 12 -and $hour -lt 18) {
    Show-ColorScript -Category Geometric -Random
} else {
    Show-ColorScript -Tag "night,dark" -Random
}
```
 
#### Scenario 2: CI/CD Pipeline
```powershell
# Build phase decoration
Show-ColorScript -Name "bars" -NoCache # Quick display without cache
New-ColorScriptCache -Category "Build" -Force # Prepare for next run
 
# In CI/CD context:
$env:CI = $true
if ($env:CI) {
    Show-ColorScript -NoCache # Avoid cache in ephemeral environments
}
```
 
#### Scenario 3: Administrative Dashboards
```powershell
# Display system-themed colorscripts
$os = if ($PSVersionTable.PSVersion.Major -ge 7) { "pwsh" } else { "powershell" }
Show-ColorScript -Name $os -PassThru | Out-Null
 
# Show status information
Get-ColorScriptList -Tag "system" -AsObject |
    ForEach-Object { Write-Host "Available: $($_.Name)" }
```
 
#### Scenario 4: Educational Presentations
```powershell
# Interactive colorscript showcase
Show-ColorScript -All -WaitForInput
# Users can press space to advance, q to quit
 
# Or with specific category
Show-ColorScript -All -Category Abstract -WaitForInput
```
 
#### Scenario 5: Multi-User Environment
```powershell
# Per-user configuration
Set-ColorScriptConfiguration -CachePath "\\shared\cache\$env:USERNAME"
Set-ColorScriptConfiguration -DefaultScript "team-logo"
 
# Shared scripts with user customization
Get-ColorScriptList -AsObject |
    Where-Object { $_.Tags -contains "shared" } |
    ForEach-Object { Show-ColorScript -Name $_.Name }
```
 
### ADVANCED TOPICS
 
#### Topic 1: Cache Strategy Selection
Different caching strategies for different scenarios:
 
**Full Cache Strategy** (Optimal for Workstations)
```powershell
New-ColorScriptCache # Cache all 450++ scripts
# Pros: Maximum performance, instant display
# Cons: Uses 2-5MB disk space
```
 
**Selective Cache Strategy** (Optimal for Portable/CI)
```powershell
Get-ColorScriptList -Tag Recommended -AsObject |
    ForEach-Object { New-ColorScriptCache -Name $_.Name }
# Pros: Balanced performance and storage
# Cons: Requires more setup
```
 
**No Cache Strategy** (Optimal for Development)
```powershell
Show-ColorScript -NoCache
# Pros: See script changes immediately
# Cons: Slower display, more resource usage
```
 
#### Topic 2: Metadata Organization
Understanding and organizing colorscripts by metadata:
 
**Categories** - Broad organizational groupings:
- Geometric: Fractals, mathematical patterns
- Nature: Landscapes, organic themes
- Artistic: Creative, abstract designs
- Gaming: Game-related themes
- System: OS/technology themed
 
**Tags** - Specific descriptors:
- Recommended: Curated for general use
- Animated: Moving/changing patterns
- Colorful: Multi-color palettes
- Minimal: Simple, clean designs
- Retro: Classic 80s/90s aesthetics
 
#### Topic 3: Performance Optimization Tips
```powershell
# Tip 1: Pre-load frequently used scripts
New-ColorScriptCache -Name bars,arch,mandelbrot-zoom,aurora-waves
 
# Tip 2: Monitor cache staleness
$old = Get-ChildItem "$env:APPDATA\ColorScripts-Enhanced\cache" -Filter "*.cache" |
    Where-Object { $_.LastWriteTime -lt (Get-Date).AddMonths(-1) }
 
# Tip 3: Use category filtering for faster selection
Show-ColorScript -Category Geometric # Faster than full set
 
# Tip 4: Enable verbose output for debugging
Show-ColorScript -Name aurora -Verbose
```
 
#### Topic 4: Cross-Platform Considerations
```powershell
# Windows Terminal specific
if ($env:WT_SESSION) {
    Show-ColorScript # Full color support
}
 
# VS Code integrated terminal
if ($env:TERM_PROGRAM -eq "vscode") {
    Show-ColorScript -Name nerd-font-test # Font support
}
 
# SSH session
if ($env:SSH_CONNECTION) {
    Show-ColorScript -NoCache # Avoid slow network cache I/O
}
 
# Linux/macOS terminal
if ($PSVersionTable.PSVersion.Major -ge 7) {
    Show-ColorScript -Category Nature # Use Unix-friendly scripts
}
```
 
#### Topic 5: Scripting and Automation
```powershell
# Create reusable function for daily greeting
function Show-DailyColorScript {
    $seed = (Get-Date).DayOfYear
    Get-Random -SetSeed $seed
    Show-ColorScript -Random -Category @("Geometric", "Nature") -Random
}
 
# Use in profile
Show-DailyColorScript
 
# Create script rotation function
function Invoke-ColorScriptSlideshow {
    param(
        [int]$Interval = 3,
        [string[]]$Category,
        [int]$Count
    )
 
    $scripts = if ($Category) {
        Get-ColorScriptList -Category $Category -AsObject
    } else {
        Get-ColorScriptList -AsObject
    }
 
    $scripts | Select-Object -First $Count | ForEach-Object {
        Show-ColorScript -Name $_.Name
        Start-Sleep -Seconds $Interval
    }
}
 
# Usage
Invoke-ColorScriptSlideshow -Interval 2 -Category Geometric -Count 5
```
 
### TROUBLESHOOTING GUIDE
 
#### Issue 1: Scripts Not Displaying Correctly
**Symptoms**: Garbled characters or missing colors
**Solutions**:
```powershell
# Set UTF-8 encoding
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 
# Check terminal supports UTF-8
Write-Host "Test: ✓ ✗ ◆ ○" -ForegroundColor Green
 
# Use nerd font test
Show-ColorScript -Name nerd-font-test
 
# If still broken, disable cache
Show-ColorScript -Name yourscript -NoCache
```
 
#### Issue 2: Module Import Failures
**Symptoms**: "Module not found" or import errors
**Solutions**:
```powershell
# Check if module exists
Get-Module -ListAvailable | Where-Object Name -like "*Color*"
 
# Check PSModulePath
$env:PSModulePath -split [System.IO.Path]::PathSeparator
 
# Reinstall module
Remove-Module ColorScripts-Enhanced
Uninstall-Module ColorScripts-Enhanced
Install-Module -Name ColorScripts-Enhanced -Force
```
 
#### Issue 3: Cache Not Being Used
**Symptoms**: Scripts run slowly every time
**Solutions**:
```powershell
# Verify cache exists
$cacheDir = (Get-ColorScriptConfiguration).Cache.Path
Get-ChildItem $cacheDir -Filter "*.cache" | Measure-Object
 
# Rebuild cache
Remove-Item "$cacheDir\*" -Confirm:$false
New-ColorScriptCache -Force
 
# Check for cache path issues
Get-ColorScriptConfiguration | Select-Object -ExpandProperty Cache
```
 
#### Issue 4: Profile Not Running
**Symptoms**: Colorscript doesn't show on PowerShell startup
**Solutions**:
```powershell
# Verify profile exists
Test-Path $PROFILE
 
# Check profile content
Get-Content $PROFILE | Select-String "ColorScripts"
 
# Repair profile
Add-ColorScriptProfile -Force
 
# Test profile manually
. $PROFILE
```
 
### FAQ
 
**Q: How many colorscripts are available?**
A: 450++ built-in scripts across multiple categories and tags
 
**Q: How much disk space does caching use?**
A: Approximately 2-5MB total for all scripts, about 2-50KB per script
 
**Q: Can I use colorscripts in scripts/automation?**
A: Yes, use `-ReturnText` to capture output or `-PassThru` for metadata
 
**Q: How do I create custom colorscripts?**
A: Use `New-ColorScript` to scaffold a template, then add your ANSI art
 
**Q: What if I don't want colors on startup?**
A: Use `Add-ColorScriptProfile -SkipStartupScript` to import without auto-display
 
**Q: Can I use this on macOS/Linux?**
A: Yes, with PowerShell 7+ which runs cross-platform
 
**Q: How do I share colorscripts with colleagues?**
A: Export metadata with `Export-ColorScriptMetadata` or share script files
 
**Q: Is caching always enabled?**
A: No, use `-NoCache` to disable caching for development/testing
 
### BEST PRACTICES
 
1. **Install from PowerShell Gallery**: Use `Install-Module` for automatic updates
2. **Add to Profile**: Use `Add-ColorScriptProfile` for automatic startup integration
3. **Pre-build Cache**: Run `New-ColorScriptCache` after installation for optimal performance
4. **Use Meaningful Naming**: When creating custom scripts, use descriptive names
5. **Keep Metadata Updated**: Update ScriptMetadata.psd1 when adding scripts
6. **Test in Different Terminals**: Verify scripts display correctly across your environments
7. **Monitor Cache Size**: Periodically check cache directory size and clean if needed
8. **Use Categories/Tags**: Leverage filtering for faster script discovery
9. **Document Custom Scripts**: Add descriptions and tags to custom colorscripts
10. **Backup Configuration**: Export configuration before major changes
 
### VERSION HISTORY
 
#### Version 2025.10.09
- Enhanced caching system with OS-wide cache
- 6-19x performance improvement
- Centralized cache location in AppData
- 450++ colorscripts included
- Full comment-based help documentation
- Module manifest improvements
- Advanced configuration management
- Metadata export capabilities
- Profile integration helpers
 
### COPYRIGHT
 
Copyright (c) 2025. All rights reserved.
 
### LICENSE
 
Licensed under MIT License. See LICENSE file for details.