{"id":31664060,"url":"https://github.com/cloudwerx-dev/linuxsysteminfo","last_synced_at":"2025-10-07T20:54:10.039Z","repository":{"id":316663812,"uuid":"1064354265","full_name":"CLOUDWERX-DEV/LinuxSystemInfo","owner":"CLOUDWERX-DEV","description":"🖥️ Beautiful, comprehensive system information display for Linux - Hardware monitoring, network info, development environment detection, and system health warnings with professional terminal interface. Displays CUDA, Torch, Python version and much more!","archived":false,"fork":false,"pushed_at":"2025-09-25T23:16:47.000Z","size":34,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-26T01:14:52.581Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CLOUDWERX-DEV.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-25T23:08:40.000Z","updated_at":"2025-09-25T23:17:03.000Z","dependencies_parsed_at":"2025-09-26T01:15:19.763Z","dependency_job_id":"ca46f560-4c25-4f33-8d0d-cc100e2703bc","html_url":"https://github.com/CLOUDWERX-DEV/LinuxSystemInfo","commit_stats":null,"previous_names":["cloudwerx-dev/linuxsysteminfo"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/CLOUDWERX-DEV/LinuxSystemInfo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CLOUDWERX-DEV%2FLinuxSystemInfo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CLOUDWERX-DEV%2FLinuxSystemInfo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CLOUDWERX-DEV%2FLinuxSystemInfo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CLOUDWERX-DEV%2FLinuxSystemInfo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CLOUDWERX-DEV","download_url":"https://codeload.github.com/CLOUDWERX-DEV/LinuxSystemInfo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CLOUDWERX-DEV%2FLinuxSystemInfo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278846350,"owners_count":26056090,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-07T20:54:05.273Z","updated_at":"2025-10-07T20:54:10.024Z","avatar_url":"https://github.com/CLOUDWERX-DEV.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🖥️ Linux System Info\n\n\u003cdiv align=\"center\"\u003e\n\n**🔍 Beautiful, comprehensive system information display for Linux**\n\n*Instantly visualize your system's health, hardware, and development environment.\nQuickly get Torch, CUDA, Python, NPM\\Node versions and more!*\n\n[![License](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/platform-Linux-blue.svg)](#compatibility)\n[![Shell](https://img.shields.io/badge/shell-bash-brightgreen.svg)](#requirements)\n\n![System Info Demo](docs/demo.gif)\n\n\u003c/div\u003e\n\n---\n\n## ✨ Features\n\n### 🌟 **Comprehensive Information Display**\n\n- **System Details**: Hostname, uptime, load averages, OS info, kernel version\n- **Hardware Monitoring**: CPU details, memory usage, disk space, GPU information\n- **Temperature Monitoring**: CPU temperature with color-coded status indicators\n- **Network Information**: Active interfaces, IP addresses, external IP detection\n- **Development Environment**: Python, Node.js, Docker, Git status\n- **System Health**: Automated warnings for disk space, memory usage, and load\n\n### 🎨 **Beautiful Visual Design**\n\n- **Color-coded Status**: Green ✓, Yellow ⚠, Red ✗ indicators\n- **Professional Layout**: Clean, organized information display\n- **Unicode Graphics**: Beautiful box-drawing characters and symbols\n- **Terminal Compatibility**: Works with any modern terminal emulator\n\n### ⚡ **Two Display Modes**\n\n- **Comprehensive Mode**: Detailed system overview with all information\n- **Simple Mode**: Compact, horizontally-organized quick view\n\n---\n\n## 🚀 Quick Start\n\n### One-Line Installation\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/CLOUDWERX-DEV/LinuxSystemInfo/main/install.sh | bash\n```\n\n### Manual Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/CLOUDWERX-DEV/LinuxSystemInfo.git\ncd LinuxSystemInfo\n\n# Make scripts executable\nchmod +x scripts/*.sh\n\n# Install system-wide (recommended)\nsudo ./scripts/install.sh\n\n# Or install for current user only\n./scripts/install.sh --user\n```\n\n### Quick Test\n\n```bash\n# Comprehensive view\nsysinfo\n\n# Simple view\nsysinfo-simple\n\n# Or use the short aliases\nsi       # comprehensive\nsis      # simple\n```\n\n---\n\n## 📋 Sample Output\n\n### Comprehensive Mode (`sysinfo`)\n\n```\n╔══════════════════════════════════════════════════════════════════════╗\n║ SYSTEM OVERVIEW - 2025-09-25 18:53:32                                ║\n╚══════════════════════════════════════════════════════════════════════╝\n\n▶ System Information\n──────────────────────────────────────────────────\n  Hostname:          cloudwerxdev-H18-mint\n  Current Time:      2025-09-25 18:53:32 EDT\n  Uptime:            up 1 day, 5 hours, 1 minute\n  Load Average:      4.59, 2.62, 2.63\n  OS:                Linux Mint 22.2\n  Kernel:            6.8.0-83-generic\n  Architecture:      x86_64\n\n▶ Hardware Information\n──────────────────────────────────────────────────\n  CPU:               Intel(R) Core(TM) i9-14900HX\n  Cores/Threads:     32/2\n  Memory:            22Gi/62Gi (35.4%) ✓\n  Root Disk:         826G/921G (95% used)\n  GPU:               NVIDIA GeForce RTX 4090 Laptop GPU\n  GPU Memory:        8826/ 16376 MB\n  CPU Temp:          +64.0°C ✓\n\n▶ Network Information\n──────────────────────────────────────────────────\n  wlp110s0f0:        192.168.1.100\n  External IP:       73.126.134.141\n\n▶ Development Environment\n──────────────────────────────────────────────────\n  User:              cloudwerxlab\n  Home:              /home/cloudwerxlab\n  Shell:             bash\n  Python (venv):     3.10.18 ✓\n  PyTorch:           2.6.0 ✓\n  CUDA (PyTorch):    12.4 ✓\n  Node.js:           v22.19.0 ✓\n  npm:               11.5.2\n  Docker:            28.4.0 (active) ✓\n  Git Branch:        main (clean) ✓\n\n▶ System Health\n──────────────────────────────────────────────────\n  docker:            running ✓\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nGenerated by CLOUDWERX LAB System Info • 18:53:44\n```\n\n### Simple Mode (`sysinfo-simple`)\n\n```\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n SYSTEM INFO - 2025-09-25 18:54:10 \n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nHost     : cloudwerxdev-H18-mint | Uptime   : up 1 day, 5 hours, 2 minutes\nUser     : cloudwerxlab@cloudwerxdev-H18-mint | Shell    : bash\nLoad     : 2.92, 2.42, 2.56 | Memory   : 22Gi/62Gi (35.5%)\nDisk     : 826G/921G (95%) | Python   : 3.10.18\nPyTorch  : 2.6.0 | CUDA     : 12.4\nNode.js  : v22.19.0 | npm      : 11.5.2\nGPU      : NVIDIA GeForce RTX 4090 Laptop GPU ( 8826/ 16376 MB)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n```\n\n---\n\n## 🛠️ Installation Methods\n\n### Method 1: Automated Installation (Recommended)\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/CLOUDWERX-DEV/LinuxSystemInfo/main/install.sh | bash\n```\n\n### Method 2: Manual Installation\n\n```bash\n# Download and extract\nwget https://github.com/CLOUDWERX-DEV/LinuxSystemInfo/archive/refs/heads/main.zip\nunzip main.zip\ncd LinuxSystemInfo-main\n\n# Make scripts executable\nchmod +x scripts/*.sh\n\n# Install system-wide\nsudo cp scripts/sysinfo.sh /usr/local/bin/sysinfo\nsudo cp scripts/sysinfo-simple.sh /usr/local/bin/sysinfo-simple\n\n# Or install for current user\nmkdir -p ~/.local/bin\ncp scripts/sysinfo.sh ~/.local/bin/sysinfo\ncp scripts/sysinfo-simple.sh ~/.local/bin/sysinfo-simple\necho 'export PATH=\"$HOME/.local/bin:$PATH\"' \u003e\u003e ~/.bashrc\n```\n\n### Method 3: Development Setup\n\n```bash\ngit clone https://github.com/CLOUDWERX-DEV/LinuxSystemInfo.git\ncd LinuxSystemInfo\nchmod +x scripts/*.sh\n\n# Run directly\n./scripts/sysinfo.sh\n./scripts/sysinfo-simple.sh\n```\n\n---\n\n## ⚙️ Configuration\n\n### Environment Variables\n\nCreate `~/.config/linuxsysinfo/config` to customize behavior:\n\n```bash\n# Python environment path (customize for your setup)\nPYTHON_PATH=\"/path/to/your/venv/bin/python\"\n\n# Enable/disable specific sections\nSHOW_TEMPERATURE=true\nSHOW_EXTERNAL_IP=true\nSHOW_GPU_DETAILS=true\n\n# Customize colors (advanced)\nCOLOR_GOOD=\"green\"\nCOLOR_WARN=\"yellow\"\nCOLOR_ERROR=\"red\"\n```\n\n### Bash Integration\n\nAdd helpful aliases to your `~/.bashrc`:\n\n```bash\n# Quick system info aliases\nalias si='sysinfo'\nalias sis='sysinfo-simple'\nalias sys='sysinfo'\n\n# Custom variations\nalias sysinfo-quick='sysinfo-simple'\nalias sysinfo-full='sysinfo'\n```\n\n---\n\n## 🔧 Requirements\n\n### Required Dependencies\n\n- **bash** (version 4.0+)\n- **Standard Unix utilities**: `free`, `df`, `uptime`, `hostname`, `awk`\n- **Terminal colors**: `tput` (fallback to ANSI escape codes)\n\n### Optional Dependencies (for enhanced features)\n\n- **lscpu** - Detailed CPU information\n- **nvidia-smi** - NVIDIA GPU monitoring\n- **sensors** - Temperature monitoring (`sudo apt install lm-sensors`)\n- **git** - Repository status information\n- **docker** - Docker service status\n- **systemctl** - System service monitoring\n- **curl** - External IP detection\n\n### Installation of Optional Dependencies\n\n```bash\n# Ubuntu/Debian/Linux Mint\nsudo apt update\nsudo apt install lm-sensors util-linux pciutils\n\n# Setup temperature monitoring\nsudo sensors-detect --auto\n```\n\n---\n\n## 🌍 Compatibility\n\n### Tested Distributions\n\n- ✅ **Ubuntu** 20.04, 22.04, 24.04\n- ✅ **Linux Mint** 21, 22\n- ✅ **Debian** 11, 12\n- ✅ **Pop!_OS** 22.04\n- ✅ **Elementary OS** 7\n- ✅ **Fedora** 38, 39\n- ✅ **CentOS Stream** 9\n- ✅ **Arch Linux** (current)\n- ✅ **Manjaro** (current)\n\n### Terminal Compatibility\n\n- ✅ **GNOME Terminal**\n- ✅ **Konsole**\n- ✅ **Alacritty**\n- ✅ **Kitty**\n- ✅ **Wezterm**\n- ✅ **tmux/screen**\n- ✅ **VS Code Integrated Terminal**\n- ✅ **SSH sessions**\n\n---\n\n## 🎨 Customization\n\n### Adding Custom Information Sections\n\nCreate custom functions following the existing pattern:\n\n```bash\n# Add to sysinfo.sh\nget_custom_info() {\n    print_section \"Custom Information\"\n\n    # Your custom data collection here\n    custom_value=$(your-command-here)\n\n    print_item \"Custom Label\" \"$custom_value\" \"ok\" \"$G\"\n}\n\n# Add the function call to main()\nmain() {\n    # ... existing code ...\n    get_custom_info\n    # ... rest of code ...\n}\n```\n\n### Color Customization\n\nModify the color definitions at the top of the scripts:\n\n```bash\n# Custom color scheme\nG=$(tput setaf 46)    # Bright green\nY=$(tput setaf 226)   # Bright yellow\nR=$(tput setaf 196)   # Bright red\nC=$(tput setaf 51)    # Bright cyan\n```\n\n### Performance Tuning\n\nFor faster execution, disable slow features:\n\n```bash\n# Comment out external IP lookup\n# external_ip=$(timeout 3 curl -s ipecho.net/plain 2\u003e/dev/null || echo \"N/A\")\n\n# Skip temperature sensors\n# if command -v sensors \u003e/dev/null 2\u003e\u00261; then\n```\n\n---\n\n## 📊 Performance\n\n### Execution Speed\n\n- **sysinfo.sh**: ~1.5-2.5 seconds (includes network lookup)\n- **sysinfo-simple.sh**: ~0.3-0.8 seconds\n\n### Resource Usage\n\n- **Memory**: \u003c5MB peak usage\n- **CPU**: Minimal impact, brief spike during execution\n- **Network**: Single HTTP request for external IP (3s timeout)\n\n### Optimization Tips\n\n- Run without external IP lookup for faster execution\n- Use simple mode for frequent checks\n- Cache results for monitoring scripts\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help:\n\n### Quick Contribution Guide\n\n1. **Fork** the repository\n2. **Create** a feature branch: `git checkout -b feature/amazing-feature`\n3. **Make** your changes\n4. **Test** on different distributions\n5. **Commit** your changes: `git commit -m 'Add amazing feature'`\n6. **Push** to the branch: `git push origin feature/amazing-feature`\n7. **Open** a Pull Request\n\n### Development Setup\n\n```bash\ngit clone https://github.com/CLOUDWERX-DEV/LinuxSystemInfo.git\ncd LinuxSystemInfo\n\n# Test your changes\n./scripts/sysinfo.sh\n./scripts/sysinfo-simple.sh\n\n# Run on different terminals/distributions if possible\n```\n\n### Contribution Ideas\n\n- 🌐 Add support for new Linux distributions\n- 🎨 Create new display themes\n- 📊 Add system monitoring features\n- 🐛 Fix compatibility issues\n- 📚 Improve documentation\n- 🧪 Add automated testing\n\n---\n\n## 📝 Changelog\n\n### v1.0.0 - September 25, 2025\n\n- 🎉 Initial release\n- ✅ Comprehensive system information display\n- ✅ Simple compact mode\n- ✅ Color-coded status indicators\n- ✅ Hardware monitoring (CPU, Memory, GPU)\n- ✅ Temperature monitoring\n- ✅ Network interface detection\n- ✅ Development environment detection\n- ✅ Git repository integration\n- ✅ System health warnings\n- ✅ Bash completion and aliases\n\n---\n\n## ❓ Troubleshooting\n\n### Common Issues\n\n**Colors not displaying properly:**\n\n```bash\n# Check terminal support\necho $TERM\n\n# Test color support\ntput setaf 2; echo \"Green text\"; tput sgr0\n\n# Fallback for older terminals\nexport TERM=xterm-256color\n```\n\n**Permission denied errors:**\n\n```bash\n# Make scripts executable\nchmod +x scripts/*.sh\n\n# Check PATH\necho $PATH | grep -o ~/.local/bin\n```\n\n**Missing information:**\n\n```bash\n# Install optional dependencies\nsudo apt install lm-sensors util-linux\n\n# Check command availability\nwhich lscpu nvidia-smi sensors\n```\n\n**GPU information not showing:**\n\n```bash\n# For NVIDIA cards\nsudo apt install nvidia-utils-*\n\n# For AMD cards (basic info via lspci)\nlspci | grep -i vga\n```\n\n### Getting Help\n\n- 📖 Check the [documentation](docs/SYSINFO_SCRIPTS.md)\n- 🐛 [Open an issue](https://github.com/CLOUDWERX-DEV/LinuxSystemInfo/issues)\n- 💬 [Start a discussion](https://github.com/CLOUDWERX-DEV/LinuxSystemInfo/discussions)\n\n---\n\n## 📄 License\n\nThis project is licensed under the **Apache License 2.0** - see the [LICENSE](LICENSE) file for details.\n\n### What this means:\n\n- ✅ **Use** it for personal and commercial projects\n- ✅ **Modify** and distribute the code\n- ✅ **Include** in larger projects\n- ✅ **Sell** products that include this code\n\n**Requirements:**\n\n- 📄 Include the original license and copyright notice\n- 📋 Document any significant changes you make\n\n---\n\n## 🙏 Acknowledgments\n\nSpecial thanks to:\n\n- 🐧 The **Linux community** for continuous inspiration\n- 💻 **Terminal emulator developers** for excellent tools\n- 🎨 **Unicode Consortium** for beautiful text graphics\n- 🛠️ **Bash developers** for the powerful shell\n- 👥 **Beta testers** and early adopters\n\n---\n\n## 🌟 Star History\n\nIf this project helps you, please consider giving it a ⭐ on GitHub!\n\n[![Star History](https://api.star-history.com/svg?repos=CLOUDWERX-DEV/LinuxSystemInfo\u0026type=Date)](https://star-history.com/#CLOUDWERX-DEV/LinuxSystemInfo\u0026Date)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by [CLOUDWERX LAB](https://cloudwerx.dev)**\n\n*\"Digital Food for the Analog Soul\"*\n\n[![Website](https://img.shields.io/badge/Website-cloudwerx.dev-blue)](https://cloudwerx.dev)\n[![Email](https://img.shields.io/badge/Email-mail@cloudwerx.dev-red)](mailto:mail@cloudwerx.dev)\n[![GitHub](https://img.shields.io/badge/GitHub-CLOUDWERX--DEV-black)](https://github.com/CLOUDWERX-DEV)\n\n**⭐ Star this repository if LinuxSystemInfo makes your Linux experience better!**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudwerx-dev%2Flinuxsysteminfo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudwerx-dev%2Flinuxsysteminfo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudwerx-dev%2Flinuxsysteminfo/lists"}