🖥️ 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 aliasesalias si='sysinfo'alias sis='sysinfo-simple'alias sys='sysinfo'# Custom variationsalias 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.shget_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 supportecho$TERM# Test color support
tput setaf 2;echo"Green text"; tput sgr0
# Fallback for older terminalsexport TERM=xterm-256color

Permission denied errors:

# Make scripts executable
chmod +x scripts/*.sh
# Check PATHecho$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
.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

Latest commit

History

Folders and files

Repository files navigation