Skip to content

AndreLFN1/CleanMyPC-PS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CleanMyPC-PS

Ferramenta de limpeza de disco para Windows via PowerShell. Escaneia, categoriza e limpa arquivos desnecessarios de forma estruturada — sem dependencias externas, sem internet, sem LLM.

Destaques

  • Backup Analyzer: Analisa pastas de backup (PC, celular Android, migracoes) e separa automaticamente arquivos pessoais (fotos, videos, documentos) de lixo de sistema. Extrai apenas o que importa e libera o resto.
  • 14 scanners automaticos: temp files, caches de GPU, browsers, package managers, jogos, downloads duplicados e mais
  • 3 perfis de limpeza: general, gamer, dev — cada um prioriza categorias diferentes
  • Menu interativo TUI: navegue com teclado e marque exatamente o que quer limpar
  • Seguro por padrao: simulacao com -WhatIf, 3 niveis de risco, log completo de tudo que e deletado

Uso Rapido

git clone https://github.com/AndreLFN1/CleanMyPC-PS.git
cd CleanMyPC-PS

# Limpeza de disco (relatorio + confirmacao por categoria)
.\CleanMyPC.ps1

# Menu interativo
.\CleanMyPC.ps1 -Interactive

# Perfil gamer (prioriza caches de GPU e jogos)
.\CleanMyPC.ps1 -Profile gamer

# Perfil dev (prioriza node_modules, pip, npm)
.\CleanMyPC.ps1 -Profile dev

# Apenas relatorio (sem limpar nada)
.\CleanMyPC.ps1 -ScanOnly

# Simulacao (mostra o que seria feito sem fazer)
.\CleanMyPC.ps1 -WhatIf

Se encontrar erro de politica de execucao, rode antes: Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Backup Analyzer

Analisa pastas de backup e separa automaticamente o que e pessoal do que e lixo de sistema. Ideal para:

  • Backup de celular Android (dump via cabo USB com DCIM, WhatsApp, Downloads misturados com Android/data)
  • Migracao entre PCs (pasta "backup do PC antigo" com tudo misturado)
  • HD externo com backup antigo que voce nunca organizou
# Analisar uma pasta de backup
.\CleanMyPC.ps1 -AnalyzeBackup "D:\backup celular"
.\CleanMyPC.ps1 -AnalyzeBackup "C:\backup PC antigo"

# Simular sem extrair nada
.\CleanMyPC.ps1 -AnalyzeBackup "D:\backup" -WhatIf

Como funciona

  1. Escaneia todos os arquivos na pasta de backup
  2. Classifica cada arquivo usando heuristicas:
    • Extensao: .jpg, .mp4, .pdf, .docx = pessoal / .dll, .sys, .exe = sistema
    • Caminho: Documents, DCIM, WhatsApp = pessoal / Program Files, AppData, Android/data = sistema
    • Tamanho: imagens < 1MB em pastas de sistema = provavelmente icones de app, nao fotos pessoais
  3. Apresenta um relatorio organizado por tipo (fotos, videos, documentos, audio)
  4. Extrai apenas os arquivos pessoais para uma pasta limpa
  5. Opcionalmente deleta o backup original

Exemplo de saida

  ============================================================
    Backup Analyzer — Relatorio
  ============================================================

    Pasta: D:\backup celular (28.5 GB)

  PESSOAL (midias e documentos encontrados)
  ---------------------------------------------------------------
    [IMG]  Fotos                          2847 arquivos      4.2 GB
             DCIM\Camera                                     2103 arq
             Pictures\Screenshots                             412 arq
    [VID]  Videos                           84 arquivos      8.1 GB
             DCIM\Camera                                       61 arq
             WhatsApp\Media\WhatsApp Video                     23 arq
    [DOC]  Documentos                      156 arquivos    320 MB
             Download                                          89 arq
    [AUD]  Audio                           412 arquivos      1.8 GB
             Music                                            380 arq
  ---------------------------------------------------------------
    TOTAL PESSOAL: 3499 arquivos (14.4 GB)

  SISTEMA / DESCARTAVEL
  ---------------------------------------------------------------
    Android                              18420 arq      12.3 GB
    .thumbnails                            847 arq       0.5 GB
    data                                  2103 arq       1.3 GB
  ---------------------------------------------------------------
    TOTAL SISTEMA: 21370 arquivos (14.1 GB)

  ============================================================
    Pessoal:      14.4 GB  (50%)
    Sistema:      14.1 GB  (49%)
  ============================================================

  O que deseja fazer?

    [1] Extrair TUDO que e pessoal para uma nova pasta
    [2] Escolher categorias para extrair (fotos, videos, docs...)
    [3] Extrair pessoal + nao classificados (mais seguro)
    [4] Apenas ver o relatorio

Classificacao: pessoal vs sistema

Pessoal Sistema
.jpg .png .heic .raw .gif .bmp .webp .dll .sys .msi .cab .cat .inf
.mp4 .avi .mkv .mov .wmv .3gp .etl .pdb .mui .nls .wad .pak
.mp3 .wav .flac .aac .ogg .m4a .client .manifest .config .esd
.pdf .doc .docx .xls .xlsx .ppt .pptx .resx .winmd .pri .appx
.txt .rtf .csv .epub .mobi

Caminhos pessoais: Documents, Pictures, DCIM, Camera, WhatsApp, Telegram, Downloads, Desktop, Screenshots, Music, Videos

Caminhos de sistema: Program Files, Windows, AppData, Android/data, .thumbnails, node_modules, .git, cache

Limpeza de Disco

O que e escaneado

Categoria O que detecta Risco
Temporarios %TEMP%, Windows\Temp, Prefetch Seguro
Caches NVIDIA DXCache/GLCache, Chrome, Edge, Firefox, Opera, Windows Installer Seguro
Dev npm-cache, pip cache, NuGet, Cargo, Gradle, Maven, Yarn, pnpm, node_modules Seguro
Downloads Arquivos > 500MB (ISOs, instaladores, ZIPs), downloads duplicados Cautela
Jogos Steam, Epic Games, Riot Games — lista cada jogo com tamanho Cautela
Sistema Windows Update downloads, crash dumps, entradas orfas no registro Seguro
Midias Pastas grandes fora do padrao, possiveis backups antigos Perigo

Niveis de Risco

  • Seguro (verde): pode limpar sem preocupacao. Caches, temp files, crash dumps — tudo e recriado automaticamente.
  • Cautela (amarelo): verifique antes. Downloads podem ter arquivos que voce ainda quer, jogos custam tempo de download.
  • Perigo (vermelho): requer confirmacao individual. Backups antigos e pastas grandes que podem conter dados pessoais.

Perfis

Perfil Foco Caso de uso
general Tudo equilibrado Limpeza geral do dia a dia
gamer Caches de GPU e jogos primeiro Precisa de espaco para instalar um novo jogo
dev node_modules, pip, npm, build artifacts Muitos projetos acumulados no disco

Modo Interativo (TUI)

  === CleanMyPC-PS - Selecione os itens para limpar ===

  -- CACHES --
> [x] NVIDIA DXCache                               14.59 GB
  [x] Google Chrome Cache                           0.85 GB
  -- JOGOS --
  [ ] Baldur's Gate 3 (Steam)                      144.69 GB
  [x] Hogwarts Legacy (Epic)                        73.61 GB

  Selecionado: 89.05 GB (3 itens)
  ↑↓ Navegar | Espaco: Marcar | A: Todos | N: Nenhum | Enter: Confirmar | Q: Sair

Itens seguros vem pre-marcados. Navegue com setas, marque/desmarque com Espaco, confirme com Enter.

Logs

Toda limpeza e registrada em ~/.cleanmypc/cleanup-log-YYYY-MM-DD_HHmmss.txt com timestamp, acao executada e resultado para cada item.

Executando com Admin

A ferramenta funciona sem privilegios de administrador, mas com admin consegue limpar:

  • Windows\Temp (limpeza completa)
  • Prefetch
  • Windows Update downloads
  • Windows Installer cache

Testes

# Requer Pester (incluso no Windows 10/11)
Invoke-Pester ./tests/

Estrutura do Projeto

CleanMyPC-PS/
├── CleanMyPC.ps1              # Entry point
├── README.md
├── LICENSE
├── modules/
│   ├── Scanner.ps1            # 14 scanners de disco
│   ├── Profiles.ps1           # Perfis (general, gamer, dev)
│   ├── Reporter.ps1           # Relatorio formatado com cores
│   ├── Cleaner.ps1            # Engine de limpeza com log
│   ├── TUI.ps1                # Menu interativo
│   └── BackupAnalyzer.ps1     # Classificacao pessoal vs sistema
└── tests/
    └── Scanner.Tests.ps1      # Testes Pester

Licenca

MIT

About

PowerShell disk cleanup tool for Windows. Scans, categorizes, and cleans temp files, caches, games, dev artifacts and more. Interactive TUI, cleanup profiles (general/gamer/dev), and WhatIf simulation.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors