https://github.com/ramdeoshubham/clolcat
A small, fast C implementation of lolcat for rainbow-colored terminal output.
https://github.com/ramdeoshubham/clolcat
ansi c cli colors command-line fun lolcat rainbow terminal truecolor
Last synced: 28 days ago
JSON representation
A small, fast C implementation of lolcat for rainbow-colored terminal output.
- Host: GitHub
- URL: https://github.com/ramdeoshubham/clolcat
- Owner: ramdeoshubham
- License: mit
- Created: 2025-09-03T14:23:39.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-09-03T15:07:56.000Z (about 1 month ago)
- Last Synced: 2025-09-03T17:12:05.210Z (about 1 month ago)
- Topics: ansi, c, cli, colors, command-line, fun, lolcat, rainbow, terminal, truecolor
- Language: C
- Homepage:
- Size: 43 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# clolcat 🌈
A small, fast C implementation of lolcat for rainbow-colored terminal output.
---
## Features
- Rainbow-colored output using **ANSI truecolor codes**
- Random starting color for each run
- Optional flags:
- `-v` / `--version` : Show version and author
- `-f ` : Set color frequency (default: 0.01)
- `-p ` : Set color spread (default: 1.0)
- `-h` / `--help` : Show this help message
- No delays; instant output
- Easy to install in user space, no `sudo` required
---
## Installation
Clone the repository and run the installer:
```bash
git clone https://github.com/ramdeoshubham/clolcat.git
cd clolcat
bash install.sh
````
This will compile `clolcat` and move it to `~/bin/`.
If `~/bin` is not in your PATH, the installer will add it to your shell configuration.
---
## Usage
Pipe text to `clolcat`:
```bash
echo "Hello Kitty!" | clolcat
cat myfile.txt | clolcat
```
Optional flags:
```bash
clolcat -v # Show version
clolcat -h # Show help
clolcat -f 0.2 # Set frequency
clolcat -p 4.0 # Set spread
clolcat -f 0.2 -p 4.0 < file.txt
```
---
## Uninstall
Since it is installed entirely in user space you just need to:
```bash
rm ~/bin/clolcat
```
That's it.
---
## License
MIT License © 2025 Shubham Ramdeo
This project is inspired by the original [lolcat](https://github.com/busyloop/lolcat) utility.