Documentation

Learn how to install, configure, and optimize your system using the Qleaner utility suite.

Installation

Linux

The preferred way to run Qleaner on Linux is via the AppImage. Ensure it has execution permissions.

Shell Commands
chmod +x Qleaner-x86_64.AppImage
./Qleaner-x86_64.AppImage

macOS & Windows

Download the .dmg or .msi installer and follow the standard installation wizard instructions.

Usage Guide

  • 1 Launch Qleaner from your application menu or terminal.
  • 2 Select the target directories (e.g., Caches, Temp, Logs).
  • 3 Run "Analyze" to see a safe preview of disposable data.
  • 4 Verify items and click "Clean" to reclaim your disk space.
  • 5 Check "System Insights" for live process monitoring.

Architecture Overview

Qleaner is built as a hybrid application using Tauri v2. The backend processing engine is written in pure Rust, utilizing the tokio runtime for asynchronous file system operations and the jwalk crate for high-speed parallel directory traversal.

The frontend layer leverages Svelte 5 and its Runes system to provide a reactive, zero-latency interface that reflects system changes in real-time without blocking the main event loop.

Need more details?

Explore our GitHub wiki for advanced configuration, plugin development, and core API documentation.

Go to GitHub Wiki