Skip to main content

Professional System Automation & Cleanup Tool

Project description

SysPilot

SysPilot Logo

License: MIT Python 3.8+ Platform CI/CD Quality Gate Status Code Coverage GitHub release GitHub issues GitHub stars Downloads

A powerful, cross-platform system cleanup and performance monitoring tool

📥 Download📖 Documentation🐛 Report Issues💬 Discussions


Overview

SysPilot is a modern system utility that helps keep your computer clean and running efficiently. It provides real-time system monitoring, automated cleanup, and intuitive visualization through both GUI and CLI interfaces.

Key Features

  • System Cleanup - Remove temporary files, cache, and free up disk space
  • Real-time Monitoring - Track CPU, memory, disk usage with interactive charts
  • Temperature Monitoring - Monitor CPU temperature with visual indicators
  • Background Operation - System tray integration and scheduled tasks
  • Cross-Platform Ready - Linux (complete), Windows & macOS (in development)

Platform Support

Platform Status Features
Linux ✅ Ready Full cleanup, monitoring, GUI
Windows 🚧 In Progress Basic structure, planned features
macOS 📋 Planned Architecture ready

Quick Start

Installation

Recommended method (using pipx):

git clone https://github.com/AFZidan/syspilot.git
cd syspilot
chmod +x install_pipx.sh
./install_pipx.sh

Alternative method:

git clone https://github.com/AFZidan/syspilot.git
cd syspilot
chmod +x install.sh
./install.sh

Usage

# Launch GUI
syspilot

# CLI mode
syspilot --cli

# Background service
syspilot --daemon

Requirements

  • Python 3.8 or higher
  • Linux (Ubuntu 18.04+, Debian 10+)
  • Required system packages (auto-installed)

Development

Setup Environment

git clone https://github.com/AFZidan/syspilot.git
cd syspilot
python3 -m venv venv
source venv/bin/activate
pip install -r requirements-dev.txt

Running Tests

python -m pytest
python -m pytest --cov=syspilot --cov-report=html

Code Quality

black syspilot/
flake8 syspilot/

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

  1. Fork the repository
  2. Create a feature branch
  3. Add tests for new functionality
  4. Ensure tests pass
  5. Submit a pull request

Roadmap

  • v1.x - ✅ Linux support (Complete)
  • v2.x - 🚧 Windows support (In Progress)
  • v3.x - 📋 macOS support (Planned)

Project Structure

syspilot/
├── core/                    # Core Qt application
├── platforms/              # Platform-specific implementations
│   ├── linux/              # ✅ Linux support (complete)
│   ├── windows/            # 🚧 Windows support (in progress)
│   └── macos/              # 📋 macOS support (planned)
├── services/               # Shared services
├── utils/                  # Configuration & utilities
└── widgets/                # GUI components & charts

License

MIT License - see LICENSE for details.

Support & Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

syspilot-1.0.0.tar.gz (102.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

syspilot-1.0.0-py3-none-any.whl (89.4 kB view details)

Uploaded Python 3

File details

Details for the file syspilot-1.0.0.tar.gz.

File metadata

  • Download URL: syspilot-1.0.0.tar.gz
  • Upload date:
  • Size: 102.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.23

File hashes

Hashes for syspilot-1.0.0.tar.gz
Algorithm Hash digest
SHA256 4196562f7a62d4a5f2d0b378d2d8dd29824500410684bfa8c3a00e94567c19ae
MD5 0e4d0618226c4d25ce0dcc8c37004910
BLAKE2b-256 2830e0c7f4639ce290215d7ae275e78ebeabcc678cc0170761455e5f51806766

See more details on using hashes here.

File details

Details for the file syspilot-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: syspilot-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 89.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.23

File hashes

Hashes for syspilot-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5cb6f14eafece851c8b6e76919fb3e709f7db00b78b9ccaf474e449b9506f29b
MD5 d1a5a304d7aa0a57b9e7e8cf96032266
BLAKE2b-256 39234f887d93439f684ac5e529ecda38d6c3649d54e2a5d16f0e5b960109ba73

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page