Skip to content

michellekylehennessey/Terminal-Rat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐭 Terminal Rat

A cute interactive rat that lives in your terminal!
Built with Rust, ratatui, crossterm, and rodio.


🎮 Features

  • Pet the rat with your keyboard or mouse
  • Rat squeaks with sound effects
  • Happiness & energy bars
  • Multiple ASCII art skins
  • Random starting skin each run
  • Switch skins live with the keyboard

⌨️ Controls

  • p / Space / Enter / Mouse click → Pet the rat 🐭
  • s → Cycle through skins
  • 1 / 2 / 3 → Jump directly to Classic / LongTail / Chubby
  • q / Esc → Quit

The Rat in its Natural Habitat

Terminal Rat Full Screenshot


🚀 Running Locally

Make sure you have Rust installed (install Rust here).

📦 Dependencies

ratatui – terminal UI

crossterm – keyboard & mouse input

rodio – squeak sound playback

rand – random skin picker

Clone this repo:

git clone https://github.com/michellekylehennessey/Terminal-Rat.git
cd Terminal-Rat
cargo run

⚠️ Loudness Warning

This project plays short squeaky sounds when you pet the rat.
If you’re wearing headphones or have speakers turned up, you may want to lower the volume first.


Fat Rat Wants a Pet

About

A cute ASCII rat you can pet in your terminal

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages