Skip to content

README.md

Latest commit

 

History

History
142 lines (99 loc) · 4.83 KB

README.md

File metadata and controls

142 lines (99 loc) · 4.83 KB

🐧 Linux Cleaner CLI

Free & Open Source Linux cleanup tool

Scan and remove junk files, caches, logs, and more — safely built with Python.

Python Version Platform: Linux
License: GNU 3.0 Maintained

Quick Start

No installation needed (just Python). Clone and run:

# 1. Clone the repository
git clone [https://github.com/SEU-USUARIO/linux-cleaner-cli.git](https://github.com/SEU-USUARIO/linux-cleaner-cli.git)

# 2. Enter the directory
cd linux-cleaner-cli

# 3. Run the cleaner
python3 -m linux_cleaner_cli.main

The CLI Will

  1. Scan system paths safely
  2. Clean caches and temporary files
  3. Log every action to your terminal

See It In Action

$ python3 -m linux_cleaner_cli.main

🚀 Iniciando Linux Deep Cleaner CLI...

🗑️ Iniciando Limpeza da Lixeira Padrão...
  📂 Processando Arquivos Deletados em: /home/user/.local/share/Trash/files
    ➡️ Removendo diretório: OldProject
    ➡️ Removendo arquivo: image.png
  🧹 Processando Metadados em: /home/user/.local/share/Trash/info
    ➡️ Removendo metadado: image.png.trashinfo

🛠️ Inicializando Limpeza de Cache de Navegadores...
  Examinando pasta: GPUCache
    ✅ Pasta removida: /home/user/.config/google-chrome/Default/GPUCache
  🦊 Limpeza de Cache do Firefox...
    ✅ Pasta removida: cache2 no perfil x8s7f.default-release

💨 Iniciando Limpeza de Arquivos Temporários em: /tmp
  📄 Removido arquivo: temporary_data.log
  ❌ Falha ao remover .X11-unix: Permission denied. Ignorando item bloqueado.

✨ Limpeza Concluída!

Features

Feature Description
🐍 Pure Python Built with native libraries (pathlib, shutil) for maximum compatibility.
🔍 Smart Scanning Identifies Chrome and Firefox caches specifically.
🔧 Modular Architecture separated into Orchestrator (Main) and Modules.
🔧 Maintenance Flush DNS cache, free purgeable space
🔒 Privacy First 100% offline — no data ever leaves your machine
🐧 Native Linux Follows XDG Base Directory standards (~/.cache, ~/.local).

What It Cleans

🟢 Safe (Always safe to delete)

Category Path What it cleans
trash ~/.local/share/Trash Empty the user's trash bin (Files & Info).
temp-files /tmp/ System temporary files (skips locked system files).
browser-cache ~/.config/google-chrome & ~/.cache/mozilla/firefox Chrome, Firefox

🟡 Coming Soon (Planned)

Category Description
user_cache General ~/.cache cleanup (excluding browsers).
dev_cache pip, npm, and node_modules cache cleanup.
system_logs Old logs in /var/log.

Development

git clone [https://github.com/SEU-USUARIO/linux-cleaner-cli.git](https://github.com/your-user/linux-cleaner-cli.git)

cd linux-cleaner-cli

# Run in modular mode (Recommended)
python3 -m APP.main

Architecture

The project follows a clean, modular structure to separate logic from execution.

linux-cleaner-cli/
├── main.py             # Orchestrator: Defines paths & calls functions
├── modules/            # The "Toolbox"
│   ├── __init__.py     # Makes it a package
│   └── cleaner.py      # Logic: The actual cleaning functi

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add some amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

📄 License GNU 3.0 — see LICENSE for details.

⚠️ Disclaimer

This tool deletes files from your system. While we've implemented safety measures (like permission checks), always ensure you have backups of important data.