System Repair Toolkit v1.0

Overview

System Repair Toolkit is a comprehensive command-line utility designed to diagnose, repair, and maintain various system issues on Windows and Linux operating systems. Built in Rust for performance and reliability, this tool provides automated repairs for common hardware and software problems, system maintenance tasks, and advanced diagnostic commands.

Version: 1.0.0

Vision

The vision of System Repair Toolkit is to create a unified, cross-platform solution that empowers users—from casual home users to IT professionals—to quickly identify and resolve system issues without needing deep technical expertise. By leveraging modern Rust capabilities, we aim to provide:

• Accessibility: Simple, intuitive interface with guided repairs.
• Efficiency: Fast diagnostics and automated fixes to minimize downtime.
• Extensibility: Modular design allowing easy addition of new repair modules and platform support.
• Reliability: Robust error handling and logging for trustworthy operations.
• Future Goals: Expand to more OS platforms, integrate AI-driven diagnostics, and provide web-based interfaces for remote management.

We envision this toolkit becoming an essential part of every system administrator's arsenal, reducing the need for multiple specialized tools and streamlining the repair process.

Features

Core Repairs

• Bluetooth & WiFi: Detect and restart wireless services.
• Audio: Identify audio devices and restart audio services.
• Disk Management: Analyze disk usage and perform cleanup.
• System Analysis: Check CPU, memory, firewall status, and system updates.
• Maintenance: Clear temporary files and analyze startup programs.
• RAM Health: Monitor and report on memory usage.

Advanced Commands (Windows-Specific)

• System File Checker (SFC /scannow)
• DISM Restore Health
• Check Disk (chkdsk) repair
• Boot sector fixes (bootrec)
• Service restarts (e.g., Cryptographic Services)
• Startup Repair
• Registry Editor launch

Additional Capabilities

• Configuration Management: Customizable settings for automation, verbosity, and more, stored in TOML format.
• Progress Indicators: Visual progress bars for long-running operations.
• Logging: Detailed logging with configurable levels using env_logger.
• Asynchronous Operations: Powered by Tokio for efficient concurrent tasks.
• Error Handling: Comprehensive error management with anyhow and thiserror.

Installation

Prerequisites

• Rust and Cargo (latest stable version recommended)
• For Windows: Administrative privileges for some repairs
• For Linux: Appropriate permissions for system commands

Building from Source

1. Clone the repository:

   git clone https://github.com/ChukwuemekaP1/system-repair-toolkit.git
   cd system-repair-toolkit
   

2. Build the project:

   cargo build --release
   

3. Run the executable:

   ./target/release/system-repair-toolkit
   

Dependencies

The toolkit relies on the following crates:

• colored: For colored terminal output
• indicatif: Progress bars and spinners
• sysinfo: System information gathering
• tokio: Asynchronous runtime
• log & env_logger: Logging facilities
• serde & toml: Configuration handling
• anyhow & thiserror: Error management
• chrono: Date and time utilities
• regex: Regular expression support

Install dependencies via Cargo:

cargo install

Usage

1. Run the toolkit:

   cargo run
   

2. Follow the interactive menu:

   • Select repair categories (e.g., Hardware Repairs, System Maintenance)
   • Choose specific issues to diagnose and fix
   • Use advanced commands for in-depth repairs

Example:

SYSTEM REPAIR TOOLKIT v1.0

1. Repair Hardware Issues
2. System Maintenance
3. Advanced Commands
4. Exit

Enter your choice:

Configuration

Edit config.toml in the project root to customize behavior:

auto_restart = true
verbose = true
log_level = "info"
confirm_actions = true
timeout_seconds = 30
show_progress = true
max_retries = 3

Screenshots

How It Works

1. Initialization: Loads configuration and sets up logging.
2. Main Loop: Displays menu and processes user input.
3. Repair Dispatch: Uses RepairCoordinator to route issues to specific modules.
4. Execution: Performs diagnostics, shows progress, and applies fixes.
5. Advanced Mode: Executes OS-specific commands with verification.

The toolkit uses sysinfo for real-time system monitoring and tokio for asynchronous operations, ensuring non-blocking repairs.

Contributing

We welcome contributions! Please follow these steps:

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

Please ensure your code follows Rust best practices and includes tests where applicable.

License

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

---

For more information, visit our documentation or contact the maintainers.