# Linux System Tuning Suite

🚀 **Intelligent system optimization toolkit for Linux desktop systems**

This repository provides automated system tuning based on hardware detection, usage patterns, and best practices for tmpfs, overlay filesystems, and kernel parameter optimization.

## ✨ **NEW: One-Button Optimizer**

🎯 **Quick Start:** `sudo ./one-button-optimizer.sh`

The **one-button optimizer** is an intelligent, interactive system optimizer that:

- 🔍 **Analyzes current optimizations** and detects suboptimal configurations
- 🤔 **Prompts for user choice** on each optimization 
- 🎯 **Applies only selected optimizations** - no forced changes
- ✅ **Recognizes existing optimal configurations** and leaves them alone
- ⚙️ **Handles mixed scenarios** where some optimizations exist but aren't ideal

### Quick Tools

- `./one-button-optimizer.sh` - **Main interactive optimizer** (recommended)
- `./quick-status-check.sh` - **Quick system status** overview (no changes)
- `./launcher.sh` - **Auto-sudo launcher** for the optimizer

## 🎯 Features

- **Hardware Detection**: Automatically detects RAM, CPU, storage configuration
- **Usage Analysis**: Identifies frequently accessed files and directories  
- **Intelligent Tuning**: Applies optimizations based on system characteristics
- **Interactive Mode**: User control over what gets optimized
- **Suboptimal Detection**: Finds and offers to fix existing but suboptimal configs
- **Modular Design**: Easy to customize and extend
- **Safe Deployment**: Backup and rollback capabilities
- **Multi-Distribution**: Works across different Linux distributions

## 🏗️ Components

### Core Scripts
- `one-button-optimizer.sh` - **🆕 Interactive one-button optimizer** 
- `tune-system.sh` - Main tuning orchestrator
- `system-analyzer.sh` - Hardware and usage analysis
- `optimizer.sh` - Apply specific optimizations
- `monitor.sh` - System monitoring and health checks

### Modules
- `modules/hardware-detection.sh` - RAM, CPU, storage detection
- `modules/usage-analysis.sh` - File access pattern analysis
- `modules/tmpfs-optimizer.sh` - tmpfs configuration
- `modules/overlay-optimizer.sh` - overlay filesystem setup
- `modules/kernel-tuning.sh` - kernel parameter optimization
- `modules/zram-optimizer.sh` - zram/zswap configuration

### Profiles
- `profiles/` - Pre-configured optimization profiles
- `configs/` - Configuration templates

## 🚀 Quick Start

```bash
# Clone the repository
git clone git@gitea.egonetix.de:root/linux_system_tuning.git
cd linux_system_tuning

# Run system analysis
sudo ./system-analyzer.sh

# Apply optimizations
sudo ./tune-system.sh --auto

# Monitor results
./monitor.sh
```

## 📊 Supported Optimizations

- **Memory Management**: zram, tmpfs, overlay filesystems
- **Kernel Tuning**: vm parameters, scheduler settings
- **Cache Optimization**: Browser, IDE, package manager caches
- **I/O Optimization**: Storage and network tuning
- **Desktop Responsiveness**: Priority and scheduling tweaks

## 🔧 Configuration

The system can be configured through:
- Interactive setup wizard
- Configuration files
- Command-line parameters
- Environment variables

## 📈 Benchmarking

Built-in benchmarking tools to measure:
- Boot time improvements
- Application startup times
- Memory utilization efficiency
- I/O performance gains

## 🛡️ Safety

- Automatic backups before changes
- Rollback capabilities
- Safe mode for testing
- Validation checks

## 📄 License

MIT License - see LICENSE file for details

## 🤝 Contributing

Contributions welcome! Please read CONTRIBUTING.md for guidelines.

---

*Making Linux systems faster, one optimization at a time* ⚡