{"id":31786362,"url":"https://github.com/nick2bad4u/ps-color-scripts-enhanced","last_synced_at":"2026-06-10T07:01:24.683Z","repository":{"id":317483601,"uuid":"1067585356","full_name":"Nick2bad4u/PS-Color-Scripts-Enhanced","owner":"Nick2bad4u","description":"šŸŽØ PS Color Scripts Enhanced w/ Caching and Cross-Platform PowerShell Support","archived":false,"fork":false,"pushed_at":"2026-06-07T06:21:48.000Z","size":132313,"stargazers_count":11,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-07T07:13:11.835Z","etag":null,"topics":["ansi","art","colorscripts","cross-platform","powershell","powershell-colors","shell-colors","terminal","terminal-art","terminal-colors"],"latest_commit_sha":null,"homepage":"https://nick2bad4u.github.io/PS-Color-Scripts-Enhanced/","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nick2bad4u.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"docs/SUPPORT.md","governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2025-10-01T04:35:43.000Z","updated_at":"2026-06-07T05:24:14.000Z","dependencies_parsed_at":"2025-10-01T07:26:01.919Z","dependency_job_id":"f0cd660d-872a-475f-b83e-727a1d4d03c1","html_url":"https://github.com/Nick2bad4u/PS-Color-Scripts-Enhanced","commit_stats":null,"previous_names":["nick2bad4u/ps-color-scripts-enhanced"],"tags_count":70,"template":false,"template_full_name":null,"purl":"pkg:github/Nick2bad4u/PS-Color-Scripts-Enhanced","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nick2bad4u%2FPS-Color-Scripts-Enhanced","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nick2bad4u%2FPS-Color-Scripts-Enhanced/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nick2bad4u%2FPS-Color-Scripts-Enhanced/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nick2bad4u%2FPS-Color-Scripts-Enhanced/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nick2bad4u","download_url":"https://codeload.github.com/Nick2bad4u/PS-Color-Scripts-Enhanced/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nick2bad4u%2FPS-Color-Scripts-Enhanced/sbom","scorecard":{"id":1238928,"data":{"date":"2025-10-17T21:03:06Z","repo":{"name":"github.com/Nick2bad4u/PS-Color-Scripts-Enhanced","commit":"89be5fad26fbd05bda5e5e17fbbad65bd57c5fde"},"scorecard":{"version":"v5.3.0","commit":"c22063e786c11f9dd714d777a687ff7c4599b600"},"score":4.7,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#code-review"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: Dependabot: .github/dependabot.yml:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dependency-update-tool"}},{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#maintained"}},{"name":"CI-Tests","score":-1,"reason":"no pull request found","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#ci-tests"}},{"name":"Security-Policy","score":4,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Warn: no linked content found","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#security-policy"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dangerous-workflow"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#license"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/label.yml:50","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/rebase.yml:11","Info: jobLevel 'pull-requests' permission set to 'read': .github/workflows/rebase.yml:12","Info: jobLevel 'contents' permission set to 'read': .github/workflows/scorecards.yml:27","Info: jobLevel 'actions' permission set to 'read': .github/workflows/scorecards.yml:28","Info: jobLevel 'issues' permission set to 'read': .github/workflows/scorecards.yml:30","Info: jobLevel 'pull-requests' permission set to 'read': .github/workflows/scorecards.yml:31","Info: jobLevel 'checks' permission set to 'read': .github/workflows/scorecards.yml:33","Info: jobLevel 'contents' permission set to 'read': .github/workflows/summary.yml:15","Info: topLevel 'contents' permission set to 'read': .github/workflows/ActionLint.yml:31","Info: topLevel 'contents' permission set to 'read': .github/workflows/dependency-review.yml:13","Info: topLevel 'contents' permission set to 'read': .github/workflows/git-sizer-dispatch.yml:12","Info: topLevel 'contents' permission set to 'read': .github/workflows/git-sizer.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/gitleaks.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/greetings.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/jekyll-gh-pages.yml:18","Info: topLevel 'contents' permission set to 'read': .github/workflows/label.yml:40","Info: topLevel 'contents' permission set to 'read': .github/workflows/mega-linter.yml:10","Warn: topLevel 'security-events' permission set to 'write': .github/workflows/osv-scanner.yml:49","Info: topLevel 'contents' permission set to 'read': .github/workflows/osv-scanner.yml:51","Info: topLevel 'actions' permission set to 'read': .github/workflows/osv-scanner.yml:52","Info: topLevel 'contents' permission set to 'read': .github/workflows/prettier.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/pssecret-scanner.yml:11","Warn: topLevel 'contents' permission set to 'write': .github/workflows/publish.yml:40","Info: topLevel 'contents' permission set to 'read': .github/workflows/rebase.yml:6","Info: topLevel 'contents' permission set to 'read': .github/workflows/repo-stats.yml:11","Info: topLevel permissions set to 'read-all': .github/workflows/scorecards.yml:16","Warn: topLevel 'security-events' permission set to 'write': .github/workflows/security-devops.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/stale.yml:32","Info: topLevel 'contents' permission set to 'read': .github/workflows/summary.yml:8","Info: topLevel 'contents' permission set to 'read': .github/workflows/test.yml:14","Info: topLevel 'contents' permission set to 'read': .github/workflows/trufflehog.yml:10","Warn: topLevel 'actions' permission set to 'write': .github/workflows/updateChangeLogs.yml:17","Warn: topLevel 'checks' permission set to 'write': .github/workflows/updateChangeLogs.yml:18","Warn: topLevel 'statuses' permission set to 'write': .github/workflows/updateChangeLogs.yml:20","Warn: topLevel 'contents' permission set to 'write': .github/workflows/updateChangeLogs.yml:15"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#token-permissions"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#sast"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":9,"reason":"dependency not pinned by hash detected -- score normalized to 9","details":["Warn: npmCommand not pinned by hash: .github/workflows/prettier.yml:42","Info: 36 out of 36 GitHub-owned GitHubAction dependencies pinned","Info: 39 out of 39 third-party GitHubAction dependencies pinned","Info: 0 out of 1 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#pinned-dependencies"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v2025.10.15.755 not signed: https://api.github.com/repos/Nick2bad4u/PS-Color-Scripts-Enhanced/releases/254599236","Warn: release artifact v2025.10.15.39 not signed: https://api.github.com/repos/Nick2bad4u/PS-Color-Scripts-Enhanced/releases/254540773","Warn: release artifact v2025.10.15.1915 not signed: https://api.github.com/repos/Nick2bad4u/PS-Color-Scripts-Enhanced/releases/254803732","Warn: release artifact v2025.10.14.551 not signed: https://api.github.com/repos/Nick2bad4u/PS-Color-Scripts-Enhanced/releases/254259119","Warn: release artifact v2025.10.14.22 not signed: https://api.github.com/repos/Nick2bad4u/PS-Color-Scripts-Enhanced/releases/254211997","Warn: release artifact v2025.10.15.755 does not have provenance: https://api.github.com/repos/Nick2bad4u/PS-Color-Scripts-Enhanced/releases/254599236","Warn: release artifact v2025.10.15.39 does not have provenance: https://api.github.com/repos/Nick2bad4u/PS-Color-Scripts-Enhanced/releases/254540773","Warn: release artifact v2025.10.15.1915 does not have provenance: https://api.github.com/repos/Nick2bad4u/PS-Color-Scripts-Enhanced/releases/254803732","Warn: release artifact v2025.10.14.551 does not have provenance: https://api.github.com/repos/Nick2bad4u/PS-Color-Scripts-Enhanced/releases/254259119","Warn: release artifact v2025.10.14.22 does not have provenance: https://api.github.com/repos/Nick2bad4u/PS-Color-Scripts-Enhanced/releases/254211997"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#signed-releases"}},{"name":"Vulnerabilities","score":9,"reason":"1 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-9965-vmph-33xx"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#vulnerabilities"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/publish.yml:43"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#packaging"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#fuzzing"}},{"name":"Branch-Protection","score":3,"reason":"branch protection is not maximal on development and all release branches","details":["Info: 'allow deletion' disabled on branch 'main'","Info: 'force pushes' disabled on branch 'main'","Info: 'branch protection settings apply to administrators' is required to merge on branch 'main'","Warn: could not determine whether codeowners review is allowed","Warn: no status checks found to merge onto branch 'main'","Warn: PRs are not required to make changes on branch 'main'; or we don't have data to detect it.If you think it might be the latter, make sure to run Scorecard with a PAT or use Repo Rules (that are always public) instead of Branch Protection settings"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#branch-protection"}},{"name":"Contributors","score":0,"reason":"project has 0 contributing companies or organizations -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#contributors"}}]},"last_synced_at":"2025-10-19T04:42:35.708Z","repository_id":317483601,"created_at":"2025-10-19T04:42:35.708Z","updated_at":"2025-10-19T04:42:35.708Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34140775,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansi","art","colorscripts","cross-platform","powershell","powershell-colors","shell-colors","terminal","terminal-art","terminal-colors"],"created_at":"2025-10-10T12:56:25.323Z","updated_at":"2026-06-10T07:01:24.631Z","avatar_url":"https://github.com/Nick2bad4u.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Credits\n\nBased on the PowerShell port [ps-color-scripts](https://github.com/scottmckendry/ps-color-scripts) by Scott McKendry, which is itself based on the excellent [shell-color-scripts](https://gitlab.com/dwt1/shell-color-scripts) by Derek Taylor.\n\n# ColorScripts-Enhanced PowerShell Module\n\n[![Tests](https://github.com/Nick2bad4u/ps-color-scripts-enhanced/actions/workflows/test.yml/badge.svg)](https://github.com/Nick2bad4u/ps-color-scripts-enhanced/actions/workflows/test.yml)\n[![Publish](https://github.com/Nick2bad4u/ps-color-scripts-enhanced/actions/workflows/publish.yml/badge.svg)](https://github.com/Nick2bad4u/ps-color-scripts-enhanced/actions/workflows/publish.yml)\n\nA high-performance PowerShell module for displaying beautiful ANSI colorscripts in your terminal with intelligent caching for 6-19x faster load times.\n\n## Features\n\nāœØ **195+ Beautiful Colorscripts** - Extensive collection of ANSI art\n\nāš” **Intelligent Caching** - 6-19x performance improvement (5-20ms load times)\n\nšŸŒ **OS-Wide Cache** - Consistent caching across all terminal sessions\n\nšŸŽÆ **Simple API** - Easy-to-use cmdlets with tab completion\n\nšŸ”„ **Auto-Update** - Cache automatically invalidates when scripts change\n\nšŸ“ **Centralized Storage** - Cache stored in `%APPDATA%\\ColorScripts-Enhanced\\cache`\n\n## Demo\n\nColorScripts-Enhanced Demo: https://i.imgur.com/FCjqkxn.mp4\n\n**Open in new tab since video is too large for github**\n\n\u003cimg width=\"780\" height=\"797\" alt=\"image\" src=\"https://github.com/user-attachments/assets/1d05d7b0-e648-47dc-a53f-d6d3f539f562\" /\u003e\n\u003cimg width=\"525\" height=\"563\" alt=\"image\" src=\"https://github.com/user-attachments/assets/4c0dbf5e-f697-4ae6-8e2b-57e5052cb4c2\" /\u003e\n\u003cimg width=\"607\" height=\"854\" alt=\"image\" src=\"https://github.com/user-attachments/assets/95953355-1ad3-4d71-a56e-9e36a67671bd\" /\u003e\n\n**+ 170~ more**\n\n## Quick Start (Less Than a Minute)\n\n```powershell\nInstall-Module -Name ColorScripts-Enhanced -Scope CurrentUser\nImport-Module ColorScripts-Enhanced\nAdd-ColorScriptProfile # Optional: add to profile immediately\nShow-ColorScript\n```\n\n\u003e Requires PowerShell 5.1 or later. PowerShell 7.4+ recommended for best performance and PSResourceGet support.\n\n## Install a Nerd Font for Custom Glyphs\n\nSeveral scripts display Nerd Font icons (powerline separators, dev icons, logos). Without a Nerd Font, those glyphs render as blank boxes. Pick one of the patched fonts from [nerdfonts.com](https://www.nerdfonts.com/) and set it as your terminal font:\n\n1. **Download** a font (e.g., _Cascadia Code_, _FiraCode_, _JetBrainsMono_) from the [Nerd Fonts releases](https://github.com/ryanoasis/nerd-fonts/releases).\n2. **Install on Windows**: extract the `.zip`, select the `.ttf` files, right-click ā†’ **Install for all users**.\n **macOS**: `brew install --cask font-caskaydia-cove-nerd-font` (or double-click in Font Book).\n **Linux**: copy the `.ttf` files to `~/.local/share/fonts` (or `/usr/local/share/fonts`), then run `fc-cache -fv`.\n3. **Update your terminal** (Windows Terminal, VS Code, Alacritty, etc.) to use the installed Nerd Font for each profile.\n4. **Verify** by running:\n\n ```powershell\n Show-ColorScript -Name nerd-font-test\n ```\n\nThe script will render checkmarks and dev icons when the font is configured correctly.\n\n## Installation\n\n### Option 1: PowerShell Gallery (Recommended)\n\nThe module is published to the PowerShell Gallery, making installation a single command:\n\n```powershell\n# PowerShellGet (Windows PowerShell 5.1 / PowerShell 7)\nInstall-Module -Name ColorScripts-Enhanced -Scope CurrentUser\n\n# PSResourceGet (PowerShell 7.4+)\nInstall-PSResource -Name ColorScripts-Enhanced -Scope CurrentUser\n\n# Update to latest release later\nUpdate-Module ColorScripts-Enhanced\n```\n\n\u003e šŸ’” Tip: Set `Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass` if your environment restricts script execution during installation.\n\n### Option 2: GitHub Packages (Optional)\n\nIf you prefer GitHub Packages (for private mirrors or enterprise environments):\n\n```powershell\n$owner = 'Nick2bad4u'\n$source = \"https://nuget.pkg.github.com/$owner/index.json\"\n\nRegister-PSRepository -Name ColorScriptsEnhanced-GitHub -SourceLocation $source -PublishLocation $source -InstallationPolicy Trusted -PackageManagementProvider NuGet\nInstall-Module -Name ColorScripts-Enhanced -Repository ColorScriptsEnhanced-GitHub -Scope CurrentUser\n```\n\nAuthenticate with a GitHub PAT (Package Read scope) if prompted.\n\n### Option 3: Manual Installation\n\n1. Copy the `ColorScripts-Enhanced` folder to one of your PowerShell module paths:\n\n ```powershell\n # See available module paths\n $env:PSModulePath -split ';'\n\n # Recommended location (user-specific)\n $modulePath = \"$env:USERPROFILE\\Documents\\PowerShell\\Modules\\ColorScripts-Enhanced\"\n\n # Copy the module folder to the destination\n Copy-Item -Path \".\\ColorScripts-Enhanced\" -Destination $modulePath -Recurse -Force\n ```\n\n2. Import the module:\n\n ```powershell\n Import-Module ColorScripts-Enhanced\n ```\n\n3. (Optional) Add to your PowerShell profile for automatic loading:\n\n ```powershell\n Add-Content -Path $PROFILE.CurrentUserAllHosts -Value \"Import-Module ColorScripts-Enhanced\"\n ```\n\n Alternatively, run `Add-ColorScriptProfile -Scope CurrentUserAllHosts -SkipStartupScript` after importing the module.\n\n### Option 4: Quick Test (Without Installation)\n\n```powershell\nImport-Module \".\\ColorScripts-Enhanced\\ColorScripts-Enhanced.psd1\"\n```\n\n### (Optional) Add to Your PowerShell Profile\n\nUse the built-in helper to import the module (and optionally display a random colorscript) at shell startup:\n\n```powershell\nAdd-ColorScriptProfile\n```\n\nKey options:\n\n- `Add-ColorScriptProfile -SkipStartupScript` ā€” import the module without showing a script on launch.\n- `Add-ColorScriptProfile -Scope CurrentUserCurrentHost` ā€” limit to the current host (e.g., just VS Code).\n- `Add-ColorScriptProfile -Path .\\MyCustomProfile.ps1` ā€” target an explicit profile file.\n\n## Usage\n\n### Display a Random Colorscript\n\n```powershell\nShow-ColorScript\n# or use the alias\nscs\n```\n\n### Display a Specific Colorscript\n\n```powershell\nShow-ColorScript -Name \"mandelbrot-zoom\"\n# or\nscs mandelbrot-zoom\n```\n\n### List All Available Colorscripts\n\n```powershell\nShow-ColorScript -List\n# or\nGet-ColorScriptList\n```\n\n### Build Cache for Faster Performance\n\n```powershell\n# Cache all colorscripts (recommended)\nBuild-ColorScriptCache -All\n\n# Cache specific colorscripts\nBuild-ColorScriptCache -Name \"bars\",\"hearts\",\"arch\"\n\n# Force rebuild cache\nBuild-ColorScriptCache -All -Force\n```\n\n### Clear Cache\n\n```powershell\n# Clear all cache files\nClear-ColorScriptCache -All\n\n# Clear specific cache\nClear-ColorScriptCache -Name \"mandelbrot-zoom\"\n```\n\n### Bypass Cache (Force Fresh Execution)\n\n```powershell\nShow-ColorScript -Name \"bars\" -NoCache\n```\n\n## Commands\n\n| Command | Alias | Description |\n| ------------------------ | ----- | ---------------------------------------------------------------------------------- |\n| `Show-ColorScript` | `scs` | Display a colorscript |\n| `Get-ColorScriptList` | - | List all available colorscripts |\n| `Build-ColorScriptCache` | - | Pre-generate cache files |\n| `Clear-ColorScriptCache` | - | Remove cache files |\n| `Add-ColorScriptProfile` | - | Append module startup snippet to your profile |\n| `Install.ps1` | - | Optional local installer with `-AddToProfile`, `-SkipStartupScript`, `-BuildCache` |\n\n## Documentation\n\n- [Quick Start](QUICKSTART.md)\n- [Quick Reference](QUICKREFERENCE.md)\n- [Module Summary](MODULE_SUMMARY.md)\n- [Development Guide](docs/Development.md)\n- [Publishing Guide](docs/Publishing.md)\n- [Release Checklist](docs/ReleaseChecklist.md)\n\n## Quality \u0026 Testing\n\n- Smoke tests (includes ScriptAnalyzer): `pwsh -NoProfile -Command \"\u0026 .\\Test-Module.ps1\"`\n- Full test suite: `Invoke-Pester -Path ./Tests`\n- Linting (module only): `pwsh -NoProfile -Command \"\u0026 .\\Lint-Module.ps1\"`\n- Linting (treat warnings as errors and include tests): `pwsh -NoProfile -Command \"\u0026 .\\Lint-Module.ps1\" -IncludeTests -TreatWarningsAsErrors`\n- Lint auto-fix (apply ScriptAnalyzer fixes, then re-run lint): `pwsh -NoProfile -Command \"\u0026 .\\Lint-Module.ps1\" -Fix`\n- Continuous integration: [`test.yml`](.github/workflows/test.yml) runs on Windows PowerShell 5.1 and PowerShell 7.4 across Windows, Linux, and macOS runners.\n\n## Release \u0026 Publishing\n\n- Automated publishing workflow: [`publish.yml`](.github/workflows/publish.yml)\n- Local helper script: `build.ps1`\n- Optional help generation: `Build-Help.ps1`\n- Documentation: [Publishing Guide](docs/Publishing.md) \u0026 [Release Checklist](docs/ReleaseChecklist.md)\n\n## Additional Package Feeds\n\n- PowerShell Gallery / NuGet.org (primary distribution)\n- GitHub Packages (optional; instructions in [Publishing Guide](docs/Publishing.md))\n- Azure Artifacts or other NuGet-compatible feeds for enterprise deployment\n\n## Contributing\n\nPlease review [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines, coding standards, and how to submit pull requests.\n\n## Performance\n\n### Before Caching\n\n- Simple scripts: 30-50ms\n- Complex scripts: 200-400ms\n\n### After Caching\n\n- All scripts: 5-20ms\n- **Improvement: 6-19x faster!**\n\n### Example Performance Gains\n\n| Script | Without Cache | With Cache | Speedup |\n| --------------- | ------------- | ---------- | ------- |\n| bars | 31ms | 5ms | **6x** |\n| gradient-bars | 65ms | 8ms | **8x** |\n| mandelbrot-zoom | 365ms | 19ms | **19x** |\n\n## Cache System\n\n### How It Works\n\n1. **First Run**: Script executes normally and output is cached\n2. **Subsequent Runs**: Cached output is displayed instantly\n3. **Auto-Invalidation**: Cache updates when source script changes\n4. **OS-Wide**: Single cache location works from any directory\n\n### Cache Location\n\n```\nC:\\Users\\[Username]\\AppData\\Roaming\\ColorScripts-Enhanced\\cache\\\n```\n\n### Cache Files\n\n- One `.cache` file per colorscript\n- Contains pre-rendered ANSI output\n- Average size: ~20KB per file\n- Total size: ~3.9MB for all 195 scripts\n\n## Examples\n\n### Add to PowerShell Profile\n\nDisplay a random colorscript every time you open PowerShell:\n\n```powershell\n# Edit your profile\nnotepad $PROFILE.CurrentUserAllHosts\n\n# Add this line:\nImport-Module ColorScripts-Enhanced\nShow-ColorScript\n```\n\n### Create Custom Alias\n\n```powershell\n# Add to profile\nSet-Alias -Name cs -Value Show-ColorScript\n```\n\n### Build Cache on Module Import\n\n```powershell\n# Add to profile after Import-Module\nImport-Module ColorScripts-Enhanced\nBuild-ColorScriptCache -All\n```\n\n## Available Colorscripts\n\nThe module includes 195 colorscripts including:\n\n- **Fractals**: mandelbrot-zoom, julia-morphing, barnsley-fern, koch-snowflake\n- **Patterns**: kaleidoscope, wave-pattern, rainbow-waves, gradient-bars\n- **Characters**: pacman, space-invaders, tux, darthvader\n- **Nature**: galaxy-spiral, aurora-storm, crystal-grid, nebula\n- **Mathematical**: fibonacci-spiral, penrose-quasicrystal, hilbert-spectrum\n- And many more!\n\nUse `Show-ColorScript -List` to see all available scripts.\n\n## Troubleshooting\n\n### Cache Not Working\n\n```powershell\n# Rebuild cache\nBuild-ColorScriptCache -All -Force\n\n# Check cache location\nexplorer \"$env:APPDATA\\ColorScripts-Enhanced\\cache\"\n```\n\n### Module Not Found\n\n```powershell\n# Verify module path\nGet-Module ColorScripts-Enhanced -ListAvailable\n\n# Check PSModulePath\n$env:PSModulePath -split ';'\n```\n\n### Colorscript Not Displaying\n\n```powershell\n# Try without cache\nShow-ColorScript -Name \"scriptname\" -NoCache\n\n# Check if script exists\nGet-ColorScriptList\n```\n\n### Icons or glyphs show as squares\n\n```powershell\n# Confirm Nerd Font installation\nShow-ColorScript -Name nerd-font-test\n\n# If icons are missing:\n# 1. Install a Nerd Font from https://www.nerdfonts.com/\n# 2. Set your terminal profile to use the installed font\n# 3. Restart the terminal session\n```\n\n## Requirements\n\n- PowerShell 5.1 or higher\n- Windows (tested on Windows 10/11)\n- ANSI-capable terminal (Windows Terminal, VS Code, etc.)\n- Nerd Font (optional but recommended for glyph-heavy scripts like `nerd-font-test`)\n\n## Architecture\n\n```\nColorScripts-Enhanced/\nā”œā”€ā”€ ColorScripts-Enhanced.psd1 # Module manifest\nā”œā”€ā”€ ColorScripts-Enhanced.psm1 # Main module file\nā”œā”€ā”€ Scripts/ # Colorscript files\nā”‚ ā”œā”€ā”€ bars.ps1\nā”‚ ā”œā”€ā”€ hearts.ps1\nā”‚ ā”œā”€ā”€ mandelbrot-zoom.ps1\nā”‚ ā””ā”€ā”€ ... (192 more)\nā””ā”€ā”€ README.md # This file\n\n%APPDATA%/ColorScripts-Enhanced/\nā””ā”€ā”€ cache/ # Cache files\n ā”œā”€ā”€ bars.cache\n ā”œā”€ā”€ hearts.cache\n ā””ā”€ā”€ ... (195 total)\n```\n\n## Contributing\n\nContributions welcome! When adding new colorscripts:\n\n1. Place `.ps1` file in `Scripts/` directory\n2. Use ANSI escape codes for colors\n3. Keep output concise (fits in standard terminal)\n4. Test with `Show-ColorScript -Name \"yourscript\" -NoCache`\n5. Build cache with `Build-ColorScriptCache -Name \"yourscript\"`\n\n## License\n\nMIT License - See LICENSE file for details\n\n## Version History\n\n### 1.0.0 (2025-09-30)\n\n- Initial release\n- 195 colorscripts included\n- High-performance caching system\n- OS-wide cache in AppData\n- Complete PowerShell module structure\n- 6-19x performance improvement\n\n## Support\n\nFor issues, questions, or contributions, please visit the GitHub repository.\n\n---\n\n**Enjoy your colorful terminal! šŸŒˆ**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnick2bad4u%2Fps-color-scripts-enhanced","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnick2bad4u%2Fps-color-scripts-enhanced","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnick2bad4u%2Fps-color-scripts-enhanced/lists"}