{"id":19713747,"url":"https://github.com/hyperb1iss/chromacat","last_synced_at":"2026-03-01T07:35:07.577Z","repository":{"id":259624021,"uuid":"879067959","full_name":"hyperb1iss/chromacat","owner":"hyperb1iss","description":"ChromaCat is a turbocharged terminal colorizer written in Rust","archived":false,"fork":false,"pushed_at":"2026-01-17T18:19:00.000Z","size":631,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-18T04:40:49.235Z","etag":null,"topics":["animation","ansi","aurora","beautiful","color","gradient","lolcat","plasma","terminal","themes"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperb1iss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"hyperb1iss","ko_fi":"hyperb1iss"}},"created_at":"2024-10-26T22:01:54.000Z","updated_at":"2026-01-17T18:19:04.000Z","dependencies_parsed_at":"2024-10-26T23:53:58.591Z","dependency_job_id":"65cea47f-b42b-4313-b86c-9396094aecf8","html_url":"https://github.com/hyperb1iss/chromacat","commit_stats":null,"previous_names":["hyperb1iss/chromacat"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hyperb1iss/chromacat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fchromacat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fchromacat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fchromacat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fchromacat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperb1iss","download_url":"https://codeload.github.com/hyperb1iss/chromacat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperb1iss%2Fchromacat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29964181,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T06:55:38.174Z","status":"ssl_error","status_checked_at":"2026-03-01T06:53:04.810Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["animation","ansi","aurora","beautiful","color","gradient","lolcat","plasma","terminal","themes"],"created_at":"2024-11-11T22:24:43.294Z","updated_at":"2026-03-01T07:35:02.566Z","avatar_url":"https://github.com/hyperb1iss.png","language":"Rust","funding_links":["https://github.com/sponsors/hyperb1iss","https://ko-fi.com/hyperb1iss","https://ko-fi.com/hyperb1iss)!"],"categories":[],"sub_categories":[],"readme":"# 😺 ChromaCat ✨\n\n\u003e _Because your terminal deserves to be fabulous_ ✨\n\n\n[![Build Status](https://img.shields.io/github/actions/workflow/status/hyperb1iss/chromacat/cicd.yml?branch=main\u0026logo=github\u0026logoColor=white)](https://github.com/hyperb1iss/chromacat/actions/workflows/cicd.yml)\n[![crates.io](https://img.shields.io/crates/v/chromacat?logo=rust)](https://crates.io/crates/chromacat)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue?logo=apache)](LICENSE)\n[![Documentation](https://img.shields.io/badge/docs.rs-latest-blue?logo=docs.rs)](https://docs.rs/chromacat)\n[![Patterns](https://img.shields.io/badge/patterns-12%2B-blue?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjIiPjxwYXRoIGQ9Ik0xMiAyMmMxMCAwIDEwLTIwIDAgLTIwQzIgMiAyIDIyIDEyIDIyeiIvPjwvc3ZnPg==)](README.md#-pattern-types)\n[![Themes](https://img.shields.io/badge/themes-40%2B-blueviolet?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjIiPjxwYXRoIGQ9Ik0xMiAyQTE0IDE0IDAgMCAwIDIgMTZhMTQgMTQgMCAwIDAgMjQgMEExNCAxNCAwIDAgMCAxMiAyeiIvPjwvc3ZnPg==)](README.md#-theme-gallery)\n\nChromaCat is a turbocharged terminal colorizer written in Rust that brings stunning gradient patterns and animations to your command-line experience. Think `lolcat` but with superpowers! 🚀\n\n\n## ✨ Features\n\n- 🎨 **Rich Pattern Library**: Twelve distinct pattern types from simple gradients to complex effects\n- 🌈 **40+ Built-in Themes**: Everything from classic rainbow to custom color schemes\n- 🔄 **Smooth Animations**: Breathe life into your terminal with fluid color transitions\n- 🎮 **Interactive Mode**: Real-time control over animations and effects\n- 🎯 **Precise Control**: Fine-tune every aspect of your gradients\n- 🦀 **Blazing Fast**: Optimized Rust implementation with minimal overhead\n- 🌍 **Full Unicode Support**: Works beautifully with emojis and international text\n- 📱 **Terminal-Aware**: Adapts to terminal dimensions and capabilities\n- 🎨 **Custom Themes**: Create and share your own color schemes\n\n## 🚀 Installation\n\n### Using Cargo (Recommended)\n\n```bash\ncargo install chromacat\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/hyperb1iss/chromacat\ncd chromacat\ncargo build --release\n```\n\n### Homebrew\n\n```bash\nbrew install hyperb1iss/tap/chromacat\n```\n\n## 🎯 Quick Start\n\n```bash\n# Basic usage\necho \"Hello, ChromaCat!\" | chromacat\n\n# Choose a theme\nls -la | chromacat -t cyberpunk\n\n# Add some animation\ncat your_file.txt | chromacat -a\n\n# Use a specific pattern\necho \"Wave pattern!\" | chromacat -p wave --param amplitude=1.5\n```\n\n## 🎨 Pattern Types\n\nChromaCat offers twelve pattern types for dynamic colorization:\n\n- `diagonal` - Angled gradient with customizable direction (default)\n- `horizontal` - Classic left-to-right gradient\n- `plasma` - Psychedelic plasma effect using sine waves\n- `ripple` - Concentric circles emanating from center\n- `wave` - Flowing wave distortion pattern\n- `spiral` - Hypnotic spiral pattern from center\n- `checkerboard` - Alternating gradient colors in a grid\n- `diamond` - Diamond-shaped gradient pattern\n- `perlin` - Organic, cloud-like noise pattern\n- `rain` - Matrix-style digital rain effect\n- `fire` - Dynamic flame simulation\n- `aurora` - Northern lights simulation\n\n## 🎨 Theme Gallery\n\nChromaCat comes with over 40 built-in themes across multiple categories. Here's a sample of what's available:\n\n### 🌌 Space Themes\n\nExperience cosmic-inspired gradients perfect for sci-fi interfaces and space-themed applications.\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003enebula\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/space/nebula.png\" alt=\"Nebula theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003ecosmos\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/space/cosmos.png\" alt=\"Cosmos theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003eaurora\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/space/aurora.png\" alt=\"Aurora theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003egalaxy\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/space/galaxy.png\" alt=\"Galaxy theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 💻 Tech Themes\n\nModern, cyberpunk-inspired themes that bring a digital aesthetic to your terminal.\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"20%\"\u003e\n\u003cstrong\u003ematrix\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/tech/matrix.png\" alt=\"Matrix theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"20%\"\u003e\n\u003cstrong\u003ecyberpunk\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/tech/cyberpunk.png\" alt=\"Cyberpunk theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"20%\"\u003e\n\u003cstrong\u003ehackerman\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/tech/hackerman.png\" alt=\"Hackerman theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"20%\"\u003e\n\u003cstrong\u003equantum\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/tech/quantum.png\" alt=\"Quantum theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 🎭 Aesthetic Themes\n\nStylish gradients perfect for creative and artistic applications.\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003epastel\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/aesthetic/pastel.png\" alt=\"Pastel theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003eneon\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/aesthetic/neon.png\" alt=\"Neon theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003eretrowave\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/aesthetic/retrowave.png\" alt=\"Retrowave theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003evaporwave\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/aesthetic/vaporwave.png\" alt=\"Vaporwave theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 🎉 Party Themes\n\nVibrant, energetic themes that bring celebration to your terminal.\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003erave\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/party/rave.png\" alt=\"Rave theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003edisco\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/party/disco.png\" alt=\"Disco theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003efestival\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/party/festival.png\" alt=\"Festival theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"25%\"\u003e\n\u003cstrong\u003ecarnival\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/party/carnival.png\" alt=\"Carnival theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 🎓 Abstract Themes\n\nExperimental and artistic gradients for unique visual effects.\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"16.66%\"\u003e\n\u003cstrong\u003efire\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/abstract/fire.png\" alt=\"Fire theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"16.66%\"\u003e\n\u003cstrong\u003etoxic\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/abstract/toxic.png\" alt=\"Toxic theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"16.66%\"\u003e\n\u003cstrong\u003eglitch\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/abstract/glitch.png\" alt=\"Glitch theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"16.66%\"\u003e\n\u003cstrong\u003eplasma\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/abstract/plasma.png\" alt=\"Plasma theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 🌈 Pride Themes\n\nCelebrate diversity with these pride flag-inspired gradients.\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"14.28%\"\u003e\n\u003cstrong\u003elesbian\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/pride/lesbian.png\" alt=\"Lesbian theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"14.28%\"\u003e\n\u003cstrong\u003etrans\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/pride/trans.png\" alt=\"Trans theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"14.28%\"\u003e\n\u003cstrong\u003enonbinary\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/pride/nonbinary.png\" alt=\"Nonbinary theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"14.28%\"\u003e\n\u003cstrong\u003eprogress\u003c/strong\u003e\u003cbr/\u003e\u003cimg src=\"docs/theme-previews/pride/progress.png\" alt=\"Progress theme\" width=\"200\" height=\"20\"/\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## 💫 Usage Examples\n\n### Basic Text Coloring\n\n```bash\n# Simple gradient\necho \"Hello, World!\" | chromacat\n\n# Use the cyberpunk theme\necho \"Hello, ChromaCat!\" | chromacat -t cyberpunk\n\n# Multiple files\nchromacat file1.txt file2.txt\n```\n\n### Pattern Selection and Customization\n\n```bash\n# Diagonal gradient at 45 degrees\nchromacat -p diagonal --param angle=45 file.txt\n\n# Plasma effect with custom settings\nchromacat -p plasma --param complexity=3.0,scale=1.5 file.txt\n\n# Wave pattern with customization\nchromacat -p wave --param amplitude=1.5,frequency=2.0 file.txt\n\n# Ripple pattern from center\nchromacat -p ripple --param wavelength=1.0,damping=0.5 file.txt\n\n# Fire effect with custom parameters\nchromacat -p fire --param \"intensity=1.5,speed=2.0,turbulence=0.7,wind=true\"\n\n# Aurora effect simulation\nchromacat -p aurora --param \"intensity=1.2,waviness=1.5,layers=4\"\n\n# Matrix-style digital rain\nchromacat -p pixel_rain --param \"speed=1.5,density=2.0,length=5,glitch=true\"\n```\n\n### Animation Effects\n\n```bash\n# Basic animation\ncat your_file.txt | chromacat -a\n\n# Smooth animation with custom FPS\nls -la | chromacat -a --fps 60 --smooth\n\n# Infinite animation\nchromacat --animate --duration 0 file.txt\n```\n\n### Advanced Usage\n\n```bash\n# Combine with other commands\ngit status | chromacat -p ripple -t neon\n\n# Custom animation speed\nfind . -type f | chromacat -a --speed 0.5\n\n# Progress logging with style\nyarn build | chromacat -t cyberpunk\n```\n\n## 🎮 Interactive Controls\n\nWhen running in animation mode (`-a`):\n\n- `Space` - Pause/Resume animation\n- `T` - Cycle through themes\n- `P` - Cycle through patterns\n- `Q` or `Esc` - Quit\n- `←` `→` - Adjust animation speed\n- `↑` `↓` - Scroll through content\n\n## 🛠 Configuration Options\n\n### Common Parameters\n\n- `--frequency \u003c0.1-10.0\u003e` - Base pattern frequency\n- `--amplitude \u003c0.1-2.0\u003e` - Pattern intensity\n- `--speed \u003c0.0-1.0\u003e` - Animation speed\n\n### Animation Settings\n\n- `--fps \u003c1-144\u003e` - Frames per second\n- `--duration \u003cseconds\u003e` - Animation duration (0 for infinite)\n- `--smooth` - Enable smooth transitions\n- `--no-color` - Disable colored output\n\n### Pattern-Specific Parameters\n\n```bash\n# Plasma\nchromacat -p plasma --param complexity=3.0,scale=1.5,blend_mode=add\n\n# Ripple\nchromacat -p ripple --param wavelength=1.0,damping=0.5,center_x=0.5,center_y=0.5\n\n# Wave\nchromacat -p wave --param amplitude=1.0,frequency=2.0,phase=0.0,offset=0.5\n\n# Spiral\nchromacat -p spiral --param density=2.0,rotation=90,expansion=1.5\n\n# Checkerboard\nchromacat -p checkerboard --param size=2,blur=0.1,rotation=45\n\n# Fire\nchromacat -p fire --param intensity=1.5,turbulence=0.8,height=1.2,wind_strength=0.5\n\n# Aurora\nchromacat -p aurora --param intensity=1.2,waviness=1.5,layers=4,spread=0.4\n\n# Pixel Rain\nchromacat -p pixel_rain --param speed=2.0,density=1.5,length=4,glitch_freq=1.0\n```\n\n## 🎨 Custom Themes\n\nChromaCat supports custom theme creation through YAML files. See our [Custom Theme Guide](docs/custom-themes.md) for detailed instructions on creating your own color schemes.\n\n```bash\n# Load and use a custom theme\nchromacat --theme-file mythemes.yaml -t my-custom-theme\n```\n\n## 🏗️ Architecture\n\nFor developers interested in ChromaCat's internal design and contributing to the project, check out our [Architecture Overview](docs/architecture.md).\n\n## 🔧 Integration Tips\n\n### Shell Aliases\n\n```bash\n# Add to your .bashrc or .zshrc\nalias cat=\"chromacat\"\nalias ls=\"ls --color=always | chromacat -t ocean\"\nalias gl=\"git log --oneline --graph | chromacat -p wave -t neon\"\n```\n\n### Build Logs\n\n```bash\n# Make your build logs fabulous\nnpm run build | chromacat -t cyberpunk\ncargo build 2\u003e\u00261 | chromacat -p plasma -t matrix\n```\n\n### System Monitoring\n\n```bash\n# Colorful system monitoring\nwatch -n1 \"ps aux | sort -rn -k 3,3 | head -n 5 | chromacat -t heat\"\n```\n\n## 🤝 Contributing\n\nYes please!\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nCreated by [Stefanie Jane 🌠](https://github.com/hyperb1iss)\n\nIf you find ChromaCat useful, [buy me a Monster Ultra Violet](https://ko-fi.com/hyperb1iss)! ⚡️\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperb1iss%2Fchromacat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperb1iss%2Fchromacat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperb1iss%2Fchromacat/lists"}