🖥️ Linux System Info

🔍 Beautiful, comprehensive system information display for Linux

Instantly visualize your system's health, hardware, and development environment. Quickly get Torch, CUDA, Python, NPM\Node versions and more!

✨ Features

🌟 Comprehensive Information Display

System Details: Hostname, uptime, load averages, OS info, kernel version
Hardware Monitoring: CPU details, memory usage, disk space, GPU information
Temperature Monitoring: CPU temperature with color-coded status indicators
Network Information: Active interfaces, IP addresses, external IP detection
Development Environment: Python, Node.js, Docker, Git status
System Health: Automated warnings for disk space, memory usage, and load

🎨 Beautiful Visual Design

Color-coded Status: Green ✓, Yellow ⚠, Red ✗ indicators
Professional Layout: Clean, organized information display
Unicode Graphics: Beautiful box-drawing characters and symbols
Terminal Compatibility: Works with any modern terminal emulator

⚡ Two Display Modes

Comprehensive Mode: Detailed system overview with all information
Simple Mode: Compact, horizontally-organized quick view

🚀 Quick Start

One-Line Installation

curl -sSL https://raw.githubusercontent.com/CLOUDWERX-DEV/LinuxSystemInfo/main/install.sh | bash

Manual Installation

# Clone the repository
git clone https://github.com/CLOUDWERX-DEV/LinuxSystemInfo.git
cd LinuxSystemInfo

# Make scripts executable
chmod +x scripts/*.sh

# Install system-wide (recommended)
sudo ./scripts/install.sh

# Or install for current user only
./scripts/install.sh --user

Quick Test

# Comprehensive view
sysinfo

# Simple view
sysinfo-simple

# Or use the short aliases
si       # comprehensive
sis      # simple

📋 Sample Output

Comprehensive Mode (`sysinfo`)

╔══════════════════════════════════════════════════════════════════════╗
║ SYSTEM OVERVIEW - 2025-09-25 18:53:32                                ║
╚══════════════════════════════════════════════════════════════════════╝

▶ System Information
──────────────────────────────────────────────────
  Hostname:          cloudwerxdev-H18-mint
  Current Time:      2025-09-25 18:53:32 EDT
  Uptime:            up 1 day, 5 hours, 1 minute
  Load Average:      4.59, 2.62, 2.63
  OS:                Linux Mint 22.2
  Kernel:            6.8.0-83-generic
  Architecture:      x86_64

▶ Hardware Information
──────────────────────────────────────────────────
  CPU:               Intel(R) Core(TM) i9-14900HX
  Cores/Threads:     32/2
  Memory:            22Gi/62Gi (35.4%) ✓
  Root Disk:         826G/921G (95% used)
  GPU:               NVIDIA GeForce RTX 4090 Laptop GPU
  GPU Memory:        8826/ 16376 MB
  CPU Temp:          +64.0°C ✓

▶ Network Information
──────────────────────────────────────────────────
  wlp110s0f0:        192.168.1.100
  External IP:       73.126.134.141

▶ Development Environment
──────────────────────────────────────────────────
  User:              cloudwerxlab
  Home:              /home/cloudwerxlab
  Shell:             bash
  Python (venv):     3.10.18 ✓
  PyTorch:           2.6.0 ✓
  CUDA (PyTorch):    12.4 ✓
  Node.js:           v22.19.0 ✓
  npm:               11.5.2
  Docker:            28.4.0 (active) ✓
  Git Branch:        main (clean) ✓

▶ System Health
──────────────────────────────────────────────────
  docker:            running ✓

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Generated by CLOUDWERX LAB System Info • 18:53:44

Simple Mode (`sysinfo-simple`)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 SYSTEM INFO - 2025-09-25 18:54:10 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Host     : cloudwerxdev-H18-mint | Uptime   : up 1 day, 5 hours, 2 minutes
User     : cloudwerxlab@cloudwerxdev-H18-mint | Shell    : bash
Load     : 2.92, 2.42, 2.56 | Memory   : 22Gi/62Gi (35.5%)
Disk     : 826G/921G (95%) | Python   : 3.10.18
PyTorch  : 2.6.0 | CUDA     : 12.4
Node.js  : v22.19.0 | npm      : 11.5.2
GPU      : NVIDIA GeForce RTX 4090 Laptop GPU ( 8826/ 16376 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛠️ Installation Methods

Method 1: Automated Installation (Recommended)

curl -sSL https://raw.githubusercontent.com/CLOUDWERX-DEV/LinuxSystemInfo/main/install.sh | bash

Method 2: Manual Installation

# Download and extract
wget https://github.com/CLOUDWERX-DEV/LinuxSystemInfo/archive/refs/heads/main.zip
unzip main.zip
cd LinuxSystemInfo-main

# Make scripts executable
chmod +x scripts/*.sh

# Install system-wide
sudo cp scripts/sysinfo.sh /usr/local/bin/sysinfo
sudo cp scripts/sysinfo-simple.sh /usr/local/bin/sysinfo-simple

# Or install for current user
mkdir -p ~/.local/bin
cp scripts/sysinfo.sh ~/.local/bin/sysinfo
cp scripts/sysinfo-simple.sh ~/.local/bin/sysinfo-simple
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

Method 3: Development Setup

git clone https://github.com/CLOUDWERX-DEV/LinuxSystemInfo.git
cd LinuxSystemInfo
chmod +x scripts/*.sh

# Run directly
./scripts/sysinfo.sh
./scripts/sysinfo-simple.sh

⚙️ Configuration

Environment Variables

Create ~/.config/linuxsysinfo/config to customize behavior:

# Python environment path (customize for your setup)
PYTHON_PATH="/path/to/your/venv/bin/python"

# Enable/disable specific sections
SHOW_TEMPERATURE=true
SHOW_EXTERNAL_IP=true
SHOW_GPU_DETAILS=true

# Customize colors (advanced)
COLOR_GOOD="green"
COLOR_WARN="yellow"
COLOR_ERROR="red"

Bash Integration

Add helpful aliases to your ~/.bashrc:

# Quick system info aliases
alias si='sysinfo'
alias sis='sysinfo-simple'
alias sys='sysinfo'

# Custom variations
alias sysinfo-quick='sysinfo-simple'
alias sysinfo-full='sysinfo'

🔧 Requirements

Required Dependencies

bash (version 4.0+)
Standard Unix utilities: free, df, uptime, hostname, awk
Terminal colors: tput (fallback to ANSI escape codes)

Optional Dependencies (for enhanced features)

lscpu - Detailed CPU information
nvidia-smi - NVIDIA GPU monitoring
sensors - Temperature monitoring (sudo apt install lm-sensors)
git - Repository status information
docker - Docker service status
systemctl - System service monitoring
curl - External IP detection

Installation of Optional Dependencies

# Ubuntu/Debian/Linux Mint
sudo apt update
sudo apt install lm-sensors util-linux pciutils

# Setup temperature monitoring
sudo sensors-detect --auto

🌍 Compatibility

Tested Distributions

✅ Ubuntu 20.04, 22.04, 24.04
✅ Linux Mint 21, 22
✅ Debian 11, 12
✅ Pop!_OS 22.04
✅ Elementary OS 7
✅ Fedora 38, 39
✅ CentOS Stream 9
✅ Arch Linux (current)
✅ Manjaro (current)

Terminal Compatibility

✅ GNOME Terminal
✅ Konsole
✅ Alacritty
✅ Kitty
✅ Wezterm
✅ tmux/screen
✅ VS Code Integrated Terminal
✅ SSH sessions

🎨 Customization

Adding Custom Information Sections

Create custom functions following the existing pattern:

# Add to sysinfo.sh
get_custom_info() {
    print_section "Custom Information"

    # Your custom data collection here
    custom_value=$(your-command-here)

    print_item "Custom Label" "$custom_value" "ok" "$G"
}

# Add the function call to main()
main() {
    # ... existing code ...
    get_custom_info
    # ... rest of code ...
}

Color Customization

Modify the color definitions at the top of the scripts:

# Custom color scheme
G=$(tput setaf 46)    # Bright green
Y=$(tput setaf 226)   # Bright yellow
R=$(tput setaf 196)   # Bright red
C=$(tput setaf 51)    # Bright cyan

Performance Tuning

For faster execution, disable slow features:

# Comment out external IP lookup
# external_ip=$(timeout 3 curl -s ipecho.net/plain 2>/dev/null || echo "N/A")

# Skip temperature sensors
# if command -v sensors >/dev/null 2>&1; then

📊 Performance

Execution Speed

sysinfo.sh: ~1.5-2.5 seconds (includes network lookup)
sysinfo-simple.sh: ~0.3-0.8 seconds

Resource Usage

Memory: <5MB peak usage
CPU: Minimal impact, brief spike during execution
Network: Single HTTP request for external IP (3s timeout)

Optimization Tips

Run without external IP lookup for faster execution
Use simple mode for frequent checks
Cache results for monitoring scripts

🤝 Contributing

We welcome contributions! Here's how you can help:

Quick Contribution Guide

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes
Test on different distributions
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

Development Setup

git clone https://github.com/CLOUDWERX-DEV/LinuxSystemInfo.git
cd LinuxSystemInfo

# Test your changes
./scripts/sysinfo.sh
./scripts/sysinfo-simple.sh

# Run on different terminals/distributions if possible

Contribution Ideas

🌐 Add support for new Linux distributions
🎨 Create new display themes
📊 Add system monitoring features
🐛 Fix compatibility issues
📚 Improve documentation
🧪 Add automated testing

📝 Changelog

v1.0.0 - September 25, 2025

🎉 Initial release
✅ Comprehensive system information display
✅ Simple compact mode
✅ Color-coded status indicators
✅ Hardware monitoring (CPU, Memory, GPU)
✅ Temperature monitoring
✅ Network interface detection
✅ Development environment detection
✅ Git repository integration
✅ System health warnings
✅ Bash completion and aliases

❓ Troubleshooting

Common Issues

Colors not displaying properly:

# Check terminal support
echo $TERM

# Test color support
tput setaf 2; echo "Green text"; tput sgr0

# Fallback for older terminals
export TERM=xterm-256color

Permission denied errors:

# Make scripts executable
chmod +x scripts/*.sh

# Check PATH
echo $PATH | grep -o ~/.local/bin

Missing information:

# Install optional dependencies
sudo apt install lm-sensors util-linux

# Check command availability
which lscpu nvidia-smi sensors

GPU information not showing:

# For NVIDIA cards
sudo apt install nvidia-utils-*

# For AMD cards (basic info via lspci)
lspci | grep -i vga

Getting Help

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

What this means:

✅ Use it for personal and commercial projects
✅ Modify and distribute the code
✅ Include in larger projects
✅ Sell products that include this code

Requirements:

📄 Include the original license and copyright notice
📋 Document any significant changes you make

🙏 Acknowledgments

Special thanks to:

🐧 The Linux community for continuous inspiration
💻 Terminal emulator developers for excellent tools
🎨 Unicode Consortium for beautiful text graphics
🛠️ Bash developers for the powerful shell
👥 Beta testers and early adopters

🌟 Star History

If this project helps you, please consider giving it a ⭐ on GitHub!

Made with ❤️ by CLOUDWERX LAB

"Digital Food for the Analog Soul"

⭐ Star this repository if LinuxSystemInfo makes your Linux experience better!

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
.github		.github
docs		docs
examples		examples
scripts		scripts
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
install.sh		install.sh

License

CLOUDWERX-DEV/LinuxSystemInfo

Folders and files

Latest commit

History

Repository files navigation