☕ CoffeeCat v5.0.1 — CRIMSON WATCHER

🐱‍💻 Linux Rescue Toolkit · Dark Edition · by psyhusk

---

💜 Apoie o Desenvolvimento

O CoffeeCat é um projeto de código aberto, arquitetado e desenvolvido 100% em ambiente mobile. Meu objetivo é criar ferramentas de alta performance que facilitem o fluxo de trabalho de profissionais da área, mesmo com as limitações técnicas do meu setup atual.

Se esta ferramenta foi útil para você, considere apoiar o projeto:

👉 patreon.com/cw/Psyhusk/membership

Seu apoio é fundamental para que eu possa continuar dedicando tempo integral ao desenvolvimento, à correção de bugs e à implementação de novas funcionalidades.

Todo apoio é muito bem-vindo e me ajuda a manter este ecossistema vivo e em constante evolução. 🙏

---

📖 Sobre o Projeto

CoffeeCat Crimson Watcher é um toolkit de resgate e diagnóstico Linux com interface gráfica completa, projetado para administradores, técnicos e entusiastas que precisam de uma ferramenta poderosa, automatizada e pronta para uso em situações críticas.

🔴 Tudo funciona com um clique — a ferramenta faz o trabalho pesado por você.

---

✨ Funcionalidades

📊 Live Monitor

• CPU, RAM e I/O de disco em tempo real, atualizado a cada 2 segundos
• Temperatura dos núcleos com alerta visual quando acima de 85 °C
• Alerta automático quando RAM ultrapassa 90%
• Listagem dos processos mais pesados ao vivo

🩺 Network Triage — Diagnóstico de Rede

• Detecção automática de interfaces com status (ip link)
• Teste de conectividade em camadas: Gateway → DNS → Internet
• Configuração manual de IP/CIDR, Gateway e DNS direto na UI
• Scan de portas abertas locais via ss -tulnp
• Botões de ação rápida: Forçar DHCP e Resetar NetworkManager

📸 Disk Snapshot & Backup

• Clonar disco inteiro com progresso em tempo real via pv
• Criar imagem comprimida .img.gz com destino configurável
• Restore de imagem com validação SHA256 antes e depois
• Geração e salvamento automático de arquivo .sha256

🧯 Filesystem Repair

• fsck automatizado com seleção de partição e modo (-n, -y, -f)
• Suporte a ext4, btrfs (btrfs check --repair) e xfs (xfs_repair)
• Detecção automática do tipo de sistema de arquivos
• Modo dry-run seguro para checar sem modificar nada

🔐 Secure Wipe — Apagamento Seguro

• Três métodos: zeros (rápido), /dev/urandom (aleatório), DoD 5220.22-M (3 passes)
• Progresso em tempo real com porcentagem
• Confirmação dupla antes de executar — não tem volta
• Proteção contra wipe em disco montado

🔑 SSH Key Manager — via Chroot

• Gerar novo par de chaves ed25519 direto no sistema montado
• Injetar chave pública no authorized_keys de qualquer usuário
• Reparar permissões (chmod 700 .ssh / chmod 600 authorized_keys)
• Tudo executado dentro do chroot, sem precisar bootar o sistema

📦 Package Rescue — APT/dpkg via Chroot

• apt --fix-broken install automático
• Limpeza de locks travados (/var/lib/dpkg/lock, /var/cache/apt)
• dpkg --configure -a com um clique
• Reinstalação de qualquer pacote (ex: linux-image-generic, systemd)

🗂 File Browser — Navegador de Emergência

• Navegar pelo sistema de arquivos da partição montada
• Visualizar arquivos de texto (logs, configs) inline na UI
• Copiar arquivos/diretórios para destino seguro
• Exportar lista de arquivos modificados nas últimas 24h (find -mtime -1)

🛠 Recovery

• Reparo de GRUB (grub-install + update-grub) via chroot
• Reset de senha de qualquer usuário via chroot
• Montagem/desmontagem manual de chroot com bind mounts (/dev, /proc, /sys)

💿 USB Installer

• Gravar ISO local ou baixar de URL direto para o pendrive
• Progresso em tempo real via pv
• Validação de checksum SHA256 após gravação
• Proteção contra gravação em disco montado

🔬 Hardware

• Informações completas de CPU, RAM e discos
• Status SMART com setores realocados, horas de uso e temperatura
• Detecção automática de todos os discos e partições

---

🗂 Estrutura de Arquivos

coffeecat/
├── coffeecat.py              # 🔧 Toolkit principal (rode com sudo)
├── coffeecat_installer.py    # 🎨 Instalador gráfico (janela Crimson)
├── build_coffeecat.py        # 🏗  Script de build (PyInstaller)
└── README.md                 # 📖 Este arquivo

---

🚀 Como Usar

▶ Execução direta (sem instalar)

# Instalar dependências Python
pip install customtkinter psutil

# Rodar o toolkit (root necessário para operações de disco)
sudo python3 coffeecat.py

📦 Instalação via instalador gráfico

python3 coffeecat_installer.py

O instalador irá:

1. Instalar as dependências Python automaticamente
2. Copiar os arquivos para ~/.local/share/coffeecat/
3. Criar atalho em ~/.local/bin/coffeecat
4. Criar entrada .desktop para o menu de aplicativos

🏗 Build de executável standalone

# Instalar PyInstaller e dependências
pip install pyinstaller customtkinter psutil Pillow

# Buildar
python3 build_coffeecat.py

# Resultado em:
# dist/CoffeeCat_v501_CrimsonWatcher        (Linux/macOS)
# dist/CoffeeCat_v501_CrimsonWatcher.exe    (Windows)

---

⚙️ Dependências

Python (instaladas automaticamente)

Pacote	Uso
customtkinter	Interface gráfica moderna
psutil	Métricas de CPU, RAM e disco
Pillow	Conversão de ícone (apenas build)

Ferramentas do sistema (recomendadas)

sudo apt install smartmontools grub2-common pv wget \
                 util-linux iproute2 btrfs-progs xfsprogs

Ferramenta	Função
smartctl	Diagnóstico SMART de discos
pv	Progresso em tempo real para dd
grub-install	Reparo do bootloader
fsck	Verificação de sistema de arquivos
btrfs	Reparo de volumes btrfs
xfs_repair	Reparo de volumes XFS
ss	Scan de portas abertas
ip / nmcli	Gestão de interfaces de rede

---

🖥 Requisitos do Sistema

Item	Mínimo
Python	3.8+
SO	Linux (Ubuntu 20.04+, Debian 11+, Arch, Fedora)
Permissões	sudo / root para operações de disco
tkinter	Incluído no Python padrão

⚠️ Operações de disco, chroot e wipe exigem root. Execute sudo python3 coffeecat.py para acesso completo.

---

🎨 Interface — Crimson Watcher

• 🔴 Tema escuro com paleta Crimson (#cc1a1a)
• 🪟 Janela do instalador frameless, transparente, com red glow animado
• 🐱 Arte de gato com olhos vermelhos e pentagrama no instalador
• 📟 Terminal de log integrado em todas as abas
• 💬 Comentários sádicos e de síndrome de deus em tempo real no log durante as operações

---

⚠️ Avisos Importantes

🔴 WIPE e CLONE são irreversíveis. O CoffeeCat exige confirmação dupla, mas não há desfazer após a execução.

🔴 Sempre confirme o dispositivo de destino antes de gravar ISO ou executar wipe.

🟡 Teste em ambiente controlado antes de usar em produção.

---

📜 Licença

Distribuído como código aberto. Use, modifique e distribua à vontade. Créditos ao autor original são apreciados. ☕

---

👤 Autor

psyhusk — desenvolvido 100% em ambiente mobile.

💜 Apoie no Patreon · ajude a manter o projeto vivo.

---

  ██████╗ ██████╗ ███████╗███████╗███████╗███████╗ ██████╗ █████╗ ████████╗
 ██╔════╝██╔═══██╗██╔════╝██╔════╝██╔════╝██╔════╝██╔════╝██╔══██╗╚══██╔══╝
 ██║     ██║   ██║█████╗  █████╗  █████╗  █████╗  ██║     ███████║   ██║   
 ██║     ██║   ██║██╔══╝  ██╔══╝  ██╔══╝  ██╔══╝  ██║     ██╔══██║   ██║   
 ╚██████╗╚██████╔╝██║     ██║     ███████╗███████╗╚██████╗██║  ██║   ██║   
  ╚═════╝ ╚═════╝ ╚═╝     ╚═╝     ╚══════╝╚══════╝ ╚═════╝╚═╝  ╚═╝   ╚═╝   

☕ CoffeeCat v5.0.1 · Crimson Watcher · by psyhusk

"Consertando o que mentes mortais quebraram. De nada, universo."