Skip to content

Latest commit

History

18 Commits

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

CatSysInfo 🐱📊

Python VersionLicensePlatform

A tiny system information utility written in Python. Shows who, where, what OS, uptime, RAM, disk — all in a cute box. Now with JSON config and colored output!

Description

CatSysInfo collects and displays key system parameters without external APIs. Just pure ctypes, psutil, shutil, os, platform, and colorama.

Features

  • Username & Hostname
  • OS & Kernel version
  • Current shell (cmd.exe, bash, etc.)
  • System uptime (days + hours)
  • RAM usage (used / total + percentage)
  • Disk usage of script's directory
  • Free space on disk
  • Colored output (pink & cyan)
  • JSON config (customizable fields, box width)
  • Cross-platform (Windows / Linux)

Installation

Requirements

  • Python 3.x
  • psutil
  • colorama

Install dependencies

pip install -r requirements.txt

Or clone and run

git clone https://github.com/FelineFantasy/CatSysInfo
cd CatSysInfo
pip install -r requirements.txt
python catsysinfo.py

Configuration

On first run, sysinfo_config.json is created automatically. You can customize:

{
"box_width": 35,
"show_uptime": true,
"show_kernel": true,
"show_shell": true,
"show_ram": true,
"show_disk": true,
"show_free": true
}

Set any field to false to hide it from the output.

Example Output

╭───────────────────────────────────╮
│ kitty@catpc │
├───────────────────────────────────┤
│ OS: Windows 10 │
│ Kernel: 10.0.19045 │
│ Shell: cmd.exe │
│ Uptime: 3d 5h │
│ RAM: 4.2/15.9GB (26%) │
│ Disk: 128.5/512.0GB (25%) │
│ Free: 383.5GB │
╰───────────────────────────────────╯

Project Structure

CatSysInfo/
├── .github/
│ └── FUNDING.yml # Support link for DonationAlerts
├── catsysinfo.py # Main script
├── sysinfo_config.json # Configuration (auto-created)
├── requirements.txt # Dependencies
├── .gitignore # Git ignore rules
└── README.md # Documentation

Requirements

  • Python 3.x
  • psutil (RAM)
  • colorama (colored output)
  • Platform: Windows / Linux

💖 Support the Project

If you enjoy CatSysInfo and want to help keep the project alive, you can support me here:

DonationAlerts

Your support helps me:

  • 🐱 Keep developing useful utilities
  • 🛠️ Fix bugs and improve features
  • ☕ Stay awake while coding at 4 AM

Every little bit is appreciated! ❤️

👤 Author

  • FelineFantasy
  • License: MIT

About

A tiny system info utility. Shows OS, uptime, RAM, disk all in a cute box.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages