RustCat - GitLite

KO | EN

gitlite — search

#llm #golang #linux #docker #nodejs #macos #java #windows #awesome #cli #vue #pytorch #security #ios

RustCat

(★ 56)

System monitoring? Nah — just watching the cat run.

File Explorer

Download Latest Version (.zip)

- config.toml
- - rust.yaml
- dependabot.yml
- - dark_cat_0.ico
  - dark_cat_1.ico
  - dark_cat_2.ico
  - dark_cat_3.ico
  - dark_cat_4.ico
  - light_cat_0.ico
  - light_cat_1.ico
  - light_cat_2.ico
  - light_cat_3.ico
  - light_cat_4.ico
- - dark_parrot_0.ico
  - dark_parrot_1.ico
  - dark_parrot_2.ico
  - dark_parrot_3.ico
  - dark_parrot_4.ico
  - dark_parrot_5.ico
  - dark_parrot_6.ico
  - dark_parrot_7.ico
  - dark_parrot_8.ico
  - dark_parrot_9.ico
  - light_parrot_0.ico
  - light_parrot_1.ico
  - light_parrot_2.ico
  - light_parrot_3.ico
  - light_parrot_4.ico
  - light_parrot_5.ico
  - light_parrot_6.ico
  - light_parrot_7.ico
  - light_parrot_8.ico
  - light_parrot_9.ico
- - dark_sleep1.png
  - dark_sleep2.png
  - dark_sleep3.png
  - dark_sleep_0.ico
  - dark_sleep_1.ico
  - dark_sleep_2.ico
  - light_sleep1.png
  - light_sleep2.png
  - light_sleep3.png
  - light_sleep_0.ico
  - light_sleep_1.ico
  - light_sleep_2.ico
- appIcon-orginal.ico
- appIcon.ico
- rustcat.desktop
- rustcat.png
- screen_mac.webp
- screen_win.webp
- - mod.rs
- app.rs
- events.rs
- icon_manager.rs
- logging.rs
- main.rs
.gitignore
build.rs
build_linux.sh
build_macos.sh
Cargo.lock
Cargo.toml
CHANGELOG.md
CLAUDE.md
flake.lock
flake.nix
Info.plist
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🐈‍⬛ RustCat

Your CPU’s new emotional support animal. Forget blinking graphs and sterile charts. RustCat is here to make your system monitoring adorable.

## 🚀 What is it?
RustCat is a lightweight, cross-platform taskbar companion that turns your CPU activity into a running cat animation. The faster the cat, the busier your CPU — no extra runtimes, no bloated dependencies, just pixel-perfect feline feedback.

![screen_win](https://raw.githubusercontent.com/bearice/RustCat/master/assets/screen_win.webp)

![screen_mac](https://raw.githubusercontent.com/bearice/RustCat/master/assets/screen_mac.webp)

Inspired by [Kyome22/RunCat_for_windows](https://github.com/Kyome22/RunCat_for_windows), thanks for the cute cat.

## 🪶 Features
Speedy Cat Visuals: Watch your system load as a tiny cat dashes across your taskbar.

No Runtime Baggage: Written in Rust, so it’s leaner than a whisker. (In human language: It's small and uses less memory.)

Platform Flair: Supports Windows, macOS, and Linux/KDE with native theme detection.

Auto Theme Matching: Your cat’s colors shift with your system's light/dark mode — drama-free style.

## 🧩 Installation
Visit the [Releases page](https://github.com/bearice/RustCat/releases) and grab the file. Double-click, and let the cat out.

### Linux / KDE

On Linux the tray icon uses the freedesktop StatusNotifierItem (SNI) protocol over D-Bus, so it integrates natively with KDE Plasma's system tray.

```bash
# from source (needs a Rust toolchain)
cargo build --release
# the binary is at target/release/rust_cat
```

### Nix / NixOS

A `flake.nix` is provided:

```bash
# run directly
nix run github:bearice/RustCat

# build into a profile / your config
nix build .#default
# -> result/bin/rust_cat, plus result/share/applications/rustcat.desktop

# dev shell
nix develop
```

Runtime helper tools (`kdialog`, `plasma-systemmonitor`) are wrapped onto `PATH` automatically; the app degrades gracefully if a tool is missing.

> Build note for packagers: the repo's `.cargo/config.toml` only enables
> `crt-static` on Windows. On Linux the build links dynamically against glibc,
> which is what most distros (and Nix) expect.

## 💬 Quote from the Dev
“RustCat doesn’t monitor your CPU. It vibes with it.” — Bearice