🐧 Linux Cleaner CLI

Free & Open Source Linux cleanup tool

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

---

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.