# termicat 🐱
A fun terminal application that displays random ASCII cat art every 15-35 seconds. Perfect for adding some feline charm to your terminal!
## THIS DOES NOT LOOK GOOD ON BIG DISPLAYS.
## IT IS BEST VIEWED ON A TERMINAL WITH A SMALL WIDTH.
## Features
- 🎨 15 different ASCII cat art designs
- ⏰ Random display interval (15-35 seconds)
- 🧹 Automatic terminal clearing between cats
- 🎲 Randomized cat selection
## Installation
### From crates.io
```bash
cargo install termicat
```
### From source
```bash
git clone https://github.com/stevecellbio/termicat
cd termicat
cargo build --release
cargo run
```
## Usage
Simply run the binary and enjoy the cat parade:
```bash
termicat
```
Optional flags let you customize the experience:
```bash
# Show cats every 5-10 seconds
termicat --min-delay 5 --max-delay 10
# Show a single cat and exit
termicat --once
```
The application will:
1. Display a random ASCII cat
2. Wait a random number of seconds between the minimum and maximum delay (defaults: 15-35 seconds)
3. Clear the terminal
4. Show another cat
5. Repeat forever (unless `--once` is used)
To stop the application, press `Ctrl+C`.
## ASCII Art Preview
Here's a sample of what you might see:
```
|\__/,| (`\
_.|o o |_ ) )
-(((---(((--------
```
```
_._ _,-'""`-._
(,-.`._,'( |\`-/|
`-.-' \ )-`( , o o)
`- \`_`"'-
```
## Why termicat?
-- it's pretty funny
## Requirements
- Rust 1.56.0 or later
## Contributing
Contributions are welcome! Feel free to:
- Add more ASCII cat designs
- Improve the display timing
- Add configuration options
- Fix bugs or improve code quality
## License
- Gpl-3.0
at your option.
## Acknowledgments
- ASCII art adapted from various online sources, including [ASCII Art Archive](https://www.asciiart.eu/) and [Xmission Cat Emailbox from the 90s](https://user.xmission.com/~emailbox/ascii_cats.htm)
- Built with ❤️ and Rust 🦀