╦  ═╗ ╦   ╔═╗
║   ╔╝   ╔═╝
╩═╝ ╩    ╚═╝

• Overview
• Features
• Screenshots
• Supported Distributions
• Installation
• Usage
• System Requirements
• Troubleshooting
• Contributing
• License

LX-Z is a comprehensive, professional-grade hardware information tool for Linux systems, designed to be the definitive alternative to CPU-Z on Windows. It provides detailed information about your system's hardware components with a beautiful, interactive command-line interface.

• ✨ Beautiful CLI Interface - Modern, colorful, and intuitive interface powered by Rich
• 🔍 Comprehensive Hardware Detection - CPU, RAM, Storage, GPU, Sensors, and more
• 🚀 Multi-Distribution Support - Works on Ubuntu, Debian, RHEL, CentOS, Fedora, and Arch
• 📊 Export Capabilities - Generate JSON and TXT reports for documentation
• ⚡ Fast & Lightweight - Minimal dependencies, maximum performance
• 🛡️ No Root Required - Basic functionality works without sudo (enhanced features need root)

• Basic Details: Model, architecture, vendor, family, stepping
• Core Configuration: Physical cores, logical processors, sockets
• Frequency: Current, minimum, and maximum clock speeds
• Cache: L1 (data/instruction), L2, and L3 cache sizes
• Capabilities: Complete CPU flags and feature set (SSE, AVX, virtualization, etc.)

• Overview: Total, available, used, and free RAM
• Swap: Complete swap space information and usage
• Memory Modules: Detailed information from DMI (requires root)
  • Size, type, speed, manufacturer
  • Physical slot location
  • Part numbers and serial numbers

• Block Devices: All storage devices (HDD/SSD detection)
• Device Details: Model, size, type, read-only status
• Partitions: Complete filesystem information
  • Mount points, filesystem types
  • Size, usage, and availability
• SMART: Health status monitoring (if available)

• Graphics Cards: All installed GPUs
• Details: Vendor, model, driver information
• VRAM: Memory size (NVIDIA GPUs)
• API Support: OpenGL and Vulkan versions

• Motherboard: Manufacturer, model, version, serial number
• BIOS/UEFI: Vendor, version, release date

• Temperature: CPU, GPU, and motherboard temperatures
• Fan Speeds: All system fan RPM readings
• Battery: Comprehensive laptop battery information
  • Capacity, status, energy levels
  • Manufacturer and model

• JSON Export: Machine-readable format for automation
• TXT Export: Human-readable detailed reports
• Timestamped: Auto-generated filenames with timestamps

╦  ═╗ ╦   ╔═╗
║   ╔╝   ╔═╝
╩═╝ ╩    ╚═╝

Linux Hardware Analyzer v1.0
A professional CPU-Z alternative for Linux

╭───────────────────────────────────────────╮
│              Main Menu                     │
├───────┬───────────────────────────────────┤
│  [1]  │ 🔹 CPU Information                 │
│  [2]  │ 🔹 Memory (RAM) Information        │
│  [3]  │ 🔹 Storage Devices                 │
│  [4]  │ 🔹 GPU Information                 │
│  [5]  │ 🔹 Motherboard & BIOS              │
│  [6]  │ 🔹 Sensors & Hardware Monitor      │
│  [7]  │ 🔹 Complete System Overview        │
│  [8]  │ 🔹 Export Report (JSON/TXT)        │
│  [0]  │ 🔹 Exit                            │
╰───────┴───────────────────────────────────╯

LX-Z has been tested and works on the following Linux distributions:

• Kernel: Linux kernel 4.x and 5.x+ supported
• VM Support: Works in both virtual machines and bare-metal
• ARM: Basic support (some features may be limited)

# Clone the repository
git clone https://github.com/sarat1kyan/LX-Z.git
cd LX-Z

# Run the installation script
chmod +x install.sh
./install.sh

# Run LX-Z
./lxz.py

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y lshw hwinfo dmidecode smartmontools \
    lm-sensors pciutils usbutils util-linux mesa-utils

RHEL/CentOS/Fedora:

sudo dnf install -y lshw hwinfo dmidecode smartmontools \
    lm_sensors pciutils usbutils util-linux mesa-demos

Arch Linux:

sudo pacman -S lshw hwinfo dmidecode smartmontools \
    lm_sensors pciutils usbutils util-linux mesa-demos

pip3 install rich --break-system-packages
# Or
pip3 install -r requirements.txt --break-system-packages

chmod +x lxz.py

sudo ln -s $(pwd)/lxz.py /usr/local/bin/lxz

# Run from installation directory
./lxz.py

# Or if you created a symlink
lxz

For full functionality, including DMI information, SMART data, and detailed sensors:

sudo ./lxz.py

• Use number keys to select menu options
• Press Enter to confirm selections
• Press Ctrl+C to exit at any time

1. Select option 8 from the main menu
2. Choose export format:
   • JSON - For automation and scripting
   • TXT - For human-readable reports
   • Both - Export in both formats

Reports are saved to your home directory with timestamps:

• ~/lxz_report_YYYYMMDD_HHMMSS.json
• ~/lxz_report_YYYYMMDD_HHMMSS.txt

• OS: Linux kernel 4.x or later
• Python: Python 3.6 or later
• Memory: 50 MB RAM
• Disk: 10 MB free space

• OS: Linux kernel 5.x or later
• Python: Python 3.8 or later
• Root Access: For full feature set
• Sensors: lm-sensors configured for temperature monitoring

Problem: Some hardware information is not accessible without root.

Solution:

sudo ./lxz.py

Problem: Rich library not installed.

Solution:

pip3 install rich --break-system-packages

Problem: lm-sensors not configured.

Solution:

sudo sensors-detect  # Answer YES to all prompts
sudo service kmod start  # Or reboot

Problem: GPU drivers not installed or lspci not available.

Solution:

# Install pciutils
sudo apt-get install pciutils  # Debian/Ubuntu
sudo dnf install pciutils      # Fedora/RHEL
sudo pacman -S pciutils        # Arch

# Install appropriate GPU drivers
# NVIDIA: nvidia-driver
# AMD: mesa-vulkan-drivers

Problem: smartmontools not installed or insufficient permissions.

Solution:

# Install smartmontools
sudo apt-get install smartmontools  # Debian/Ubuntu
sudo dnf install smartmontools      # Fedora/RHEL

# Run with sudo
sudo ./lxz.py

For debugging, you can check individual components:

# Test CPU detection
python3 -c "from utils.cpu import CPUInfo; print(CPUInfo().get_all_info())"

# Test memory detection
python3 -c "from utils.memory import MemoryInfo; print(MemoryInfo().get_all_info())"

LX-Z/
├── lxz.py                 # Main application entry point
├── install.sh             # Automated installation script
├── requirements.txt       # Python dependencies
├── README.md             # This file
├── LICENSE               # MIT License
├── utils/                # Core utility modules
│   ├── __init__.py       # Package initializer
│   ├── cpu.py           # CPU information gathering
│   ├── memory.py        # Memory and motherboard info
│   ├── storage.py       # Storage devices and partitions
│   ├── gpu.py           # GPU and graphics info
│   ├── sensors.py       # Temperature and sensors
│   └── exporter.py      # Report export functionality
└── docs/                # Documentation (if needed)

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

• Follow PEP 8 style guide for Python code
• Add docstrings to all functions and classes
• Test on multiple distributions before submitting
• Update README.md if adding new features

Found a bug? Please open an issue with:

• Your Linux distribution and version
• Python version (python3 --version)
• Steps to reproduce
• Expected vs actual behavior
• Any error messages

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

• Inspired by CPU-Z for Windows
• Built with Rich for beautiful terminal output
• Thanks to the Linux community for excellent hardware detection tools

• Issues: GitHub Issues
• Discussions: GitHub Discussions

• Real-time CPU frequency monitoring
• Network adapter information
• Overclocking detection
• Benchmark integration
• Web-based GUI interface
• Docker container support
• Raspberry Pi optimization
• Hardware comparison database