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

cargo install termicat

From source

git clone https://github.com/stevecellbio/termicat
cd termicat
cargo build --release
cargo run

Usage

Simply run the binary and enjoy the cat parade:

termicat

Optional flags let you customize the experience:

# 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 and Xmission Cat Emailbox from the 90s
• Built with ❤️ and Rust 🦀